| Oracle® Data Provider for .NET開発者ガイド 11g リリース2 (11.2.0.4) B66456-02 |
|
 前 |
 次 |
OracleDecimal構造は、データベース内のOracle NUMBERまたは任意のOracleの数値を表します。
クラスの継承
System.Object
System.ValueType
Oracle.DataAccess.Types.OracleDecimal
宣言
// ADO.NET 2.0: C# public struct OracleDecimal : IComparable, INullable, IXmlSerializable
スレッド安全性
パブリック静的メソッドはスレッドセーフですが、インスタンス・メソッドではスレッド安全性は保証されません。
備考
.NETのDecimalデータ型では最大28までの精度しか保持できませんが、OracleDecimalでは最大38までの精度を格納できます。精度が28を超える値を持つOracleDecimalからOracleDecimal.Valueプロパティにアクセスすると、例外がスローされます。OracleDecimalの実際の値を取得するには、OracleDecimal.ToString()メソッドを使用します。または、BinDataプロパティにより、OracleDecimal値をバイト配列として内部Oracle NUMBER書式で取得する方法があります。
例
// C#
using System;
using Oracle.DataAccess.Types;
class OracleDecimalSample
{
static void Main(string[] args)
{
// Illustrates the range of OracleDecimal vs. .NET decimal
OracleDecimal decimal1 = OracleDecimal.MinValue;
OracleDecimal decimal2 = OracleDecimal.MaxValue;
OracleDecimal decimal3 = new OracleDecimal(decimal.MinValue);
OracleDecimal decimal4 = new OracleDecimal(decimal.MaxValue);
// Print the ranges
Console.WriteLine("OracleDecimal can range from\n{0}\nto\n{1}\n",
decimal1, decimal2);
Console.WriteLine(".NET decimal can range from\n{0}\nto\n{1}",
decimal3, decimal4);
}
}
要件
ネームスペース: Oracle.DataAccess.Types
アセンブリ: Oracle.DataAccess.dll
ODP.NETのバージョン: ODP.NET for .NET Framework 2.0またはODP.NET for .NET Framework 4
|
関連項目: |
OracleDecimalメンバーは次の表にリストされています。
OracleDecimalコンストラクタ
OracleDecimalコンストラクタを、表14-27にリストします。
OracleDecimal静的フィールド
OracleDecimal静的フィールドを、表14-28にリストします。
表14-28 OracleDecimal静的フィールド
| フィールド | 説明 |
|---|---|
|
最大精度を表す定数(38) |
|
|
最大の位取りを表す定数(127) |
|
|
この構造の最大値である、9.9…9 x 10125を表す定数 |
|
|
最小の位取りを表す定数(-84) |
|
|
この構造の最小値である、-1.0 x 10130の定数 |
|
|
ある負の値の定数 |
|
|
|
|
|
ある正の値の定数 |
|
|
数のPI値の定数 |
|
|
ゼロ値の定数 |
OracleDecimal静的(比較)メソッド
OracleDecimal静的(比較)メソッドを、表14-29にリストします。
表14-29 OracleDecimal静的(比較)メソッド
| メソッド | 説明 |
|---|---|
|
2つの |
|
|
2つの |
|
|
2つの |
|
|
2つの |
|
|
2つの |
|
|
2つの |
OracleDecimal静的(操作)メソッド
OracleDecimal静的(操作)メソッドを、表14-30にリストします。
表14-30 OracleDecimal静的(操作)メソッド
| メソッド | 説明 |
|---|---|
|
|
|
|
2つの |
|
|
指定された桁数を持つ新しい |
|
|
|
|
|
新規の精度と位取りを持つ、新しい |
|
|
|
|
|
|
|
|
2つの指定した |
|
|
2つの指定した |
|
|
2つの |
|
|
2つの |
|
|
指定した |
|
|
|
|
|
指定した |
|
|
新規に指定された精度を持つ、新しい |
|
|
指定した |
|
|
|
|
|
指定した |
|
|
ある |
|
|
指定された位置で |
OracleDecimal静的(対数)メソッド
OracleDecimal静的(対数)メソッドを、表14-31にリストします。
表14-31 OracleDecimal静的(対数)メソッド
| メソッド | 説明 |
|---|---|
|
指定した指数に累乗したeに値が設定された、新しい |
|
|
指定した |
|
|
指定した指数に呼び出された、指定した |
OracleDecimal静的(三角法)メソッド
OracleDecimal静的(三角法)メソッドを、表14-32にリストします。
表14-32 OracleDecimal静的(三角法)メソッド
| メソッド | 説明 |
|---|---|
|
コサイン値が指定した |
|
|
サイン値が指定した |
|
|
タンジェント値が指定した |
|
|
タンジェントが2つの指定した |
|
|
指定した角度(ラジアン)のコサイン値を戻します |
|
|
指定した角度(ラジアン)のサイン値を戻します |
|
|
指定した角度(ラジアン)のタンジェント値を戻します |
|
|
指定した角度(ラジアン)の双曲線コサインを戻します |
|
|
指定した角度(ラジアン)の双曲線サインを戻します |
|
|
指定した角度(ラジアン)の双曲線タンジェントを戻します |
OracleDecimal静的(比較)演算子
OracleDecimal静的(比較)演算子を、表14-33にリストします。
表14-33 OracleDecimal静的(比較)演算子
| 演算子 | 説明 |
|---|---|
|
2つの |
|
|
|
|
|
2つの |
|
|
2つの |
|
|
2つの |
|
|
2つの |
|
|
2つの |
|
|
2つの |
|
|
2つの |
|
|
ある |
|
|
|
|
|
2つの |
OracleDecimal静的演算子(.NETタイプからOracleDecimalへの変換)
OracleDecimal静的演算子(.NETタイプからOracleDecimalへの変換)を、表14-34にリストします。
表14-34 OracleDecimal静的演算子(.NETタイプからOracleDecimalへの変換)
| 演算子 | 説明 |
|---|---|
|
インスタンス値を |
|
|
インスタンス値を |
OracleDecimal静的演算子(OracleDecimalから.NETへの変換)
OracleDecimal静的演算子(OracleDecimalから.NETへの変換)を、表14-35にリストします。
表14-35 OracleDecimal静的演算子(OracleDecimalから.NETへの変換)
| 演算子 | 説明 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
OracleDecimalプロパティ
OracleDecimalプロパティを、表14-36にリストします。
表14-36 OracleDecimalプロパティ
| プロパティ | 説明 |
|---|---|
|
Oracleの内部書式におけるOracle |
|
|
|
|
|
現行インスタンスが整数であるかどうかを示します |
|
|
現行インスタンスにNULL値があるかどうかを示します |
|
|
現行インスタンスが |
|
|
現行インスタンスに |
|
|
|
OracleDecimalインスタンス・メソッド
OracleDecimalインスタンス・メソッドを、表14-37にリストします。
表14-37 OracleDecimalインスタンス・メソッド
| メソッド | 説明 |
|---|---|
|
現行インスタンスを指定したオブジェクトと比較し、相対値を表す整数を戻します |
|
|
オブジェクトが |
|
|
現行インスタンスのハッシュ・コードを戻します |
|
|
GetType |
|
|
現行インスタンスの |
|
|
現行インスタンスの |
|
|
現行インスタンスの |
|
|
現行インスタンスの |
|
|
現行インスタンスの |
|
|
現行インスタンスの |
|
|
現行インスタンスの |
OracleDecimalコンストラクタでは、OracleDecimal構造の新規インスタンスをインスタンス化します。
オーバーロード・リスト:
このコンストラクタでは、OracleDecimal構造の新規インスタンスを作成し、指定したバイト配列にその値を設定します。このバイト配列は、Oracle NUMBER書式です。
このコンストラクタでは、OracleDecimal構造の新規インスタンスを作成し、指定したDecimal値にその値を設定します。
このコンストラクタでは、OracleDecimal構造の新規インスタンスを作成し、指定したdouble値にその値を設定します。
このコンストラクタでは、OracleDecimal構造の新規インスタンスを作成し、指定したInt32値にその値を設定します。
このコンストラクタでは、OracleDecimal構造の新規インスタンスを作成し、指定したSingle値にその値を設定します。
このコンストラクタでは、OracleDecimal構造の新規インスタンスを作成し、指定したInt64値にその値を設定します。
このコンストラクタでは、OracleDecimal構造の新規インスタンスを作成し、指定したstring値にその値を設定します。
このコンストラクタでは、指定したstring値および数値書式を使用して、OracleDecimal構造の新規インスタンスを作成します。
このコンストラクタでは、OracleDecimal構造の新規インスタンスを作成し、指定したバイト配列にその値を設定します。このバイト配列は、Oracle NUMBER書式です。
宣言
// C# public OracleDecimal(byte [] bytes);
パラメータ
bytes
内部Oracle書式でOracle NUMBERを表すバイト配列
例外
ArgumentException - bytesパラメータは内部Oracle NUMBER書式ではないか、またはbytesには無効な値があります。
ArgumentNullException - bytesパラメータがNULLです。
このコンストラクタでは、OracleDecimal構造の新規インスタンスを作成し、指定したDecimal値にその値を設定します。
宣言
// C#
public OracleDecimal(decimal decX);
パラメータ
decX
指定されたDecimal値
このコンストラクタでは、OracleDecimal構造の新規インスタンスを作成し、指定したdouble値にその値を設定します。
宣言
// C#
public OracleDecimal(double doubleX)
パラメータ
doubleX
指定されたdouble型の値
例外
OverFlowException - 指定したdoubleの値がOracleDecimalの最大値より大きいか、または最小値より小さいです。
備考
指定されたdouble型の値に従って、OracleDecimalには次の値が含まれます。
double.PositiveInfinity: 正の無限大値
double.NegativeInfinity: 負の無限大値。
double.NaN: NULL値
このコンストラクタでは、OracleDecimal構造の新規インスタンスを作成し、指定したInt32値にその値を設定します。
宣言
// C#
public OracleDecimal(int intX);
パラメータ
intX
指定されたInt32値
このコンストラクタでは、OracleDecimal構造の新規インスタンスを作成し、指定したSingle値にその値を設定します。
宣言
// C#
public OracleDecimal(float floatX);
パラメータ
floatX
指定されたfloat値
備考
指定されたfloat値に従って、OracleDecimalには次の値が含まれます。
float.PositiveInfinity: 正の無限大値
float.Negativeinfinity: 負の無限大値
float.NaN: NULL値
このコンストラクタでは、OracleDecimal構造の新規インスタンスを作成し、指定したInt64値にその値を設定します。
宣言
// C#
public OracleDecimal(long longX);
パラメータ
longX
指定されたInt64値
このコンストラクタでは、OracleDecimal構造の新規インスタンスを作成し、指定したstring値にその値を設定します。
宣言
// C#
public OracleDecimal(string numStr);
パラメータ
numStr
指定されたstring値
例外
ArgumentException - numStrパラメータはOracleDecimalの無効な文字列表現です。
ArgumentNullException - numStrパラメータがNULLです。
OverFlowException - numStrの値はOracleDecimalの最大値より大きい、または最小値より小さい値です。
このコンストラクタでは、指定したstring値および数値書式を使用して、OracleDecimal構造の新規インスタンスを作成します。
宣言
// C# public OracleDecimal(string numStr, string format);
パラメータ
numStr
指定されたstring値
format
指定された数値format
例外
ArgumentException - numStrパラメータはOracleDecimalの無効な文字列表現であるか、またはnumStrはformatで指定された数値書式ではありません。
ArgumentNullException - numStrパラメータがNULLです。
OverFlowException - numStrパラメータの値はOracleDecimalの最大値より大きい、または最小値より小さい値です。
備考
数値書式に小数点およびグループ・セパレータが含まれる場合、指定された文字列では、スレッドのOracleGlobalization.NumericCharactersで定義された文字を使用する必要があります。
数値書式に通貨記号またはISO通貨記号が含まれる場合、指定された文字列では、OracleGlobalization.Currency、OracleGlobalization.ISOCurrencyおよびOracleGlobalization.DualCurrencyプロパティで個別に定義された記号を使用する必要があります。
例
// C#
using System;
using Oracle.DataAccess.Client;
using Oracle.DataAccess.Types;
class OracleDecimalSample
{
static void Main(string[] args)
{
// Set the nls parameters related to currency
OracleGlobalization info = OracleGlobalization.GetClientInfo();
info.Currency = "$";
info.NumericCharacters = ".,";
OracleGlobalization.SetThreadInfo(info);
// Construct an OracleDecimal using a valid numeric format
OracleDecimal dec = new OracleDecimal("$2,222.22","L9G999D99");
// Print "$2,222.22"
Console.WriteLine(dec.ToString());
}
}
OracleDecimal静的フィールドを、表14-38にリストします。
表14-38 OracleDecimal静的フィールド
| フィールド | 説明 |
|---|---|
|
最大精度を表す定数(38) |
|
|
最大の位取りを表す定数(127) |
|
|
この構造の最大値である、9.9…9 x 10125を表す定数 |
|
|
最小の位取りを表す定数(-84) |
|
|
この構造の最小値である、-1.0 x 10130の定数 |
|
|
ある負の値の定数 |
|
|
|
|
|
ある正の値の定数 |
|
|
数のPI値の定数 |
|
|
ゼロ値の定数 |
この静的フィールドは、この構造の最大値である、9.9…9 x 10125(38個の9の後に88個のゼロが続く)の定数を示します。
宣言
// C# public static readonly OracleDecimal MaxValue;
この静的フィールドは、この構造の最小値である、-1.0 x 10130の定数を示します。
宣言
// C# public static readonly OracleDecimal MinValue;
この静的フィールドは、OracleDecimalインスタンスに割り当てることができるNULL値を表します。
宣言
// C# public static readonly OracleDecimal Null;
OracleDecimal静的(比較)メソッドを、表14-39にリストします。
表14-39 OracleDecimal静的(比較)メソッド
| メソッド | 説明 |
|---|---|
|
2つの |
|
|
2つの |
|
|
2つの |
|
|
2つの |
|
|
2つの |
|
|
2つの |
このメソッドでは、2つのOracleDecimal値が等しいかどうかを判断します。
宣言
// C# public static bool Equals(OracleDecimal value1, OracleDecimal value2);
パラメータ
value1
最初のOracleDecimal
value2
2番目のOracleDecimal
戻り値
2つのOracleDecimal値が等しい場合はtrueを戻し、それ以外の場合はfalseを戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleDecimalは、NULL値を持つOracleDecimalより大きい値とみなされます。
NULL値を含む2つのOracleDecimalは等しくなります。
このメソッドでは、2つのOracleDecimal値のうち、最初の値が2番目の値より大きいかどうかを判断します。
宣言
// C# public static bool GreaterThan(OracleDecimal value1, OracleDecimal value2);
パラメータ
value1
最初のOracleDecimal
value2
2番目のOracleDecimal
戻り値
2つのOracleDecimal値のうち、最初の値が2番目の値より大きい場合はtrueを戻し、それ以外の場合はfalseを戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleDecimalは、NULL値を持つOracleDecimalより大きい値とみなされます。
NULL値を含む2つのOracleDecimalは等しくなります。
このメソッドでは、2つのOracleDecimal値のうち、最初の値が2番目の値以上であるかどうかを判断します。
宣言
// C# public static bool GreaterThanOrEqual(OracleDecimal value1, OracleDecimal value2);
パラメータ
value1
最初のOracleDecimal
value2
2番目のOracleDecimal
戻り値
2つのOracleDecimal値のうち、最初の値が2番目の値以上である場合はtrueを戻し、それ以外の場合はfalseを戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleDecimalは、NULL値を持つOracleDecimalより大きい値とみなされます。
NULL値を含む2つのOracleDecimalは等しくなります。
このメソッドでは、2つのOracleDecimal値のうち、最初の値が2番目の値より小さいかどうかを判断します。
宣言
// C# public static bool LessThan(OracleDecimal value1, OracleDecimal value2);
パラメータ
value1
最初のOracleDecimal
value2
2番目のOracleDecimal
戻り値
2つのOracleDecimal値のうち、最初の値が2番目の値より小さい場合はtrueを戻し、それ以外の場合はfalseを戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleDecimalは、NULL値を持つOracleDecimalより大きい値とみなされます。
NULL値を含む2つのOracleDecimalは等しくなります。
このメソッドでは、2つのOracleDecimal値のうち、最初の値が2番目の値以下であるかどうかを判断します。
宣言
// C# public static bool LessThanOrEqual(OracleDecimal value1, OracleDecimal value2);
パラメータ
value1
最初のOracleDecimal
value2
2番目のOracleDecimal
戻り値
2つのOracleDecimal値のうち、最初の値が2番目の値以下である場合はtrueを戻し、それ以外の場合はfalseを戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleDecimalは、NULL値を持つOracleDecimalより大きい値とみなされます。
NULL値を含む2つのOracleDecimalは等しくなります。
このメソッドでは、2つのOracleDecimal値が等しくないかどうかを判断します。
宣言
// C# public static bool NotEquals(OracleDecimal value1, OracleDecimal value2);
パラメータ
value1
最初のOracleDecimal
value2
2番目のOracleDecimal
戻り値
2つのOracleDecimal値が等しくない場合はtrueを戻し、それ以外の場合はfalseを戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleDecimalは、NULL値を持つOracleDecimalより大きい値とみなされます。
NULL値を含む2つのOracleDecimalは等しくなります。
OracleDecimal静的(操作)メソッドを、表14-40にリストします。
表14-40 OracleDecimal静的(操作)メソッド
| メソッド | 説明 |
|---|---|
|
|
|
|
2つの |
|
|
指定された桁数を持つ新しい |
|
|
|
|
|
新規の精度と位取りを持つ、新しい |
|
|
|
|
|
|
|
|
2つの指定した |
|
|
2つの指定した |
|
|
2つの |
|
|
2つの |
|
|
指定した |
|
|
|
|
|
指定した |
|
|
新規に指定された精度を持つ、新しい |
|
|
指定した |
|
|
|
|
|
指定した |
|
|
ある |
|
|
指定された位置で |
このメソッドでは、OracleDecimalの絶対値を戻します。
宣言
// C#
public static OracleDecimal Abs(OracleDecimal val);
パラメータ
val
OracleDecimal
戻り値
OracleDecimalの絶対値
備考
引数のいずれかにNULL値がある場合、戻されたOracleDecimalにはNULL値があります。
このメソッドにより、2つのOracleDecimal構造を加えます。
宣言
// C# public static OracleDecimal Add(OracleDecimal val1, OracleDecimal val2);
パラメータ
val1
最初のOracleDecimal
val2
2番目のOracleDecimal
戻り値
OracleDecimal構造を戻します。
備考
引数のいずれかにNULL値がある場合、戻されたOracleDecimalにはNULL値があります。
このメソッドにより、指定された桁数を持つ新しいOracleDecimalを戻し、位取りが元より小さい場合に数値を四捨五入するか切り捨てるかを示します。
宣言
// C# public static OracleDecimal AdjustScale(OracleDecimal val, int digits, bool fRound);
パラメータ
val
OracleDecimal
digits
桁数
fRound
数値を四捨五入するか切り捨てるかを示します。trueに設定すると数値を四捨五入し、falseに設定すると数値を切り捨てます。
戻り値
OracleDecimal
備考
指定したOracleDecimalにNULL値がある場合、戻されたOracleDecimalにはNULL値があります。
例
// C#
using System;
using Oracle.DataAccess.Types;
class AdjustScaleSample
{
static void Main(string[] args)
{
OracleDecimal dec1 = new OracleDecimal(5.555);
// Adjust Scale to 2 with rounding off
OracleDecimal dec2 = OracleDecimal.AdjustScale(dec1, 2, true);
// Prints 5.56
Console.WriteLine(dec2.ToString());
// Adjust Scale to 2 with truncation
OracleDecimal dec3 = OracleDecimal.AdjustScale(dec1, 2, false);
// Prints 5.55
Console.WriteLine(dec3.ToString());
}
}
このメソッドにより、指定したOracleDecimalの上限に値が設定された、新しいOracleDecimal構造を戻します。
宣言
// C#
public static OracleDecimal Ceiling(OracleDecimal val);
パラメータ
val
OracleDecimal
戻り値
新しいOracleDecimal構造
備考
引数のいずれかにNULL値がある場合、戻されたOracleDecimalにはNULL値があります。
このメソッドにより、新規の精度と位取りを持つ、新しいOracleDecimal構造を戻します。
宣言
// C# public static OracleDecimal ConvertToPrecScale(OracleDecimal val int precision, int scale);
パラメータ
val
OracleDecimal構造。
precision
精度。精度の範囲は1から38です。
scale
小数点の右の桁数。位取りの範囲は-84から127です。
戻り値
新しいOracleDecimal構造
備考
指定したOracleDecimalにNULL値がある場合、戻されたOracleDecimalにはNULL値があります。
例
// C#
using System;
using Oracle.DataAccess.Types;
class ConvertToPrecScaleSample
{
static void Main(string[] args)
{
OracleDecimal dec1 = new OracleDecimal(555.6666);
// Set the precision of od to 5 and scale to 2
OracleDecimal dec2 = OracleDecimal.ConvertToPrecScale(dec1,5,2);
// Prints 555.67
Console.WriteLine(dec2.ToString());
// Set the precision of od to 3 and scale to 0
OracleDecimal dec3 = OracleDecimal.ConvertToPrecScale(dec1,3,0);
// Prints 556
Console.WriteLine(dec3.ToString());
}
}
このメソッドにより、あるOracleDecimal値を別の値で割ります。
宣言
// C# public static OracleDecimal Divide(OracleDecimal val1, OracleDecimal val2);
パラメータ
val1
OracleDecimal
val2
OracleDecimal
戻り値
新しいOracleDecimal構造
備考
引数のいずれかにNULL値がある場合、戻されたOracleDecimalにはNULL値があります。
このメソッドにより、指定したOracleDecimal構造の下限に値が設定された、新しいOracleDecimal構造を戻します。
宣言
// C#
public static OracleDecimal Floor(OracleDecimal val);
パラメータ
val
OracleDecimal構造。
戻り値
新しいOracleDecimal構造
備考
引数のいずれかにNULL値がある場合、戻されたOracleDecimalにはNULL値があります。
このメソッドにより、2つの指定したOracleDecimal構造の最大値を戻します。
宣言
// C# public static OracleDecimal Max(OracleDecimal val1, OracleDecimal val2);
パラメータ
val1
OracleDecimal構造。
val2
OracleDecimal構造。
戻り値
より大きな値を持つOracleDecimal構造
このメソッドにより、2つの指定したOracleDecimal構造の最小値を戻します。
宣言
// C# public static OracleDecimal Min(OracleDecimal val1, OracleDecimal val2);
パラメータ
val1
OracleDecimal構造。
val2
OracleDecimal構造。
戻り値
より小さな値を持つOracleDecimal構造
このメソッドにより、2つのOracleDecimal構造のモジュールに値が設定された、新しいOracleDecimal構造を戻します。
宣言
// C# public static OracleDecimal Mod(OracleDecimal val1, OracleDecimal divider);
パラメータ
val1
OracleDecimal構造。
divider
OracleDecimal構造。
戻り値
OracleDecimal
備考
引数のいずれかにNULL値がある場合、戻されたOracleDecimalにはNULL値があります。
このメソッドにより、2つのOracleDecimal構造を掛けた結果に値が設定された、新しいOracleDecimal構造を戻します。
宣言
// C# public static OracleDecimal Multiply(OracleDecimal val1, OracleDecimal val2);
パラメータ
val1
OracleDecimal構造。
val2
OracleDecimal構造。
戻り値
新しいOracleDecimal構造
備考
引数のいずれかにNULL値がある場合、戻されたOracleDecimalにはNULL値があります。
このメソッドにより、指定したOracleDecimal構造の否定に値が設定された、新しいOracleDecimal構造を戻します。
宣言
// C#
public static OracleDecimal Negate(OracleDecimal val);
パラメータ
val
OracleDecimal構造。
戻り値
新しいOracleDecimal構造
備考
引数のいずれかにNULL値がある場合、戻されたOracleDecimalにはNULL値があります。
このメソッドにより、stringがOracleDecimalに変換されます。
宣言
// C#
public static OracleDecimal Parse (string str);
パラメータ
str
変換される文字列
戻り値
新しいOracleDecimal構造
例外
ArgumentException - numStrパラメータはOracleDecimalの無効な文字列表現です。
ArgumentNullException - numStrパラメータがNULLです。
OverFlowException - numStrの値はOracleDecimalの最大値より大きい、または最小値より小さい値です。
このメソッドにより、指定したOracleDecimal構造の値、および指定された位置で四捨五入された値に値が設定された、新しいOracleDecimal構造を戻します。
宣言
// C# public static OracleDecimal Round(OracleDecimal val, int decplace);
パラメータ
val
OracleDecimal構造。
decplace
指定された小数点の位置。値が正である場合、この機能によりOracleDecimal構造の小数点第2位を四捨五入(切り捨て)します。値が負である場合、この機能により小数点第1位を四捨五入(切り捨て)します。
戻り値
OracleDecimal構造。
備考
指定したOracleDecimal構造にNULL値がある場合、戻されたOracleDecimalにはNULL値があります。
このメソッドにより、新規の指定された精度を持つ、新しいOracleDecimal構造を戻します。
宣言
// C# public static OracleDecimal SetPrecision(OracleDecimal val, int precision);
パラメータ
val
OracleDecimal構造。
precision
指定された精度。精度の範囲は1から38です。
戻り値
OracleDecimal構造。
備考
指定された精度がvalの精度より小さい場合、戻されたOracleDecimalは四捨五入されます。
valにNULL値がある場合、戻されたOracleDecimalにはNULL値があります。
例
// C#
using System;
using Oracle.DataAccess.Types;
class SetPrecisionSample
{
static void Main(string[] args)
{
OracleDecimal dec1 = new OracleDecimal(555.6666);
// Set the precision of dec1 to 3
OracleDecimal dec2 = OracleDecimal.SetPrecision(dec1, 3);
// Prints 556
Console.WriteLine(dec2.ToString());
// Set the precision of dec1 to 4
OracleDecimal dec3 = OracleDecimal.SetPrecision(dec1, 4);
// Prints 555.7
Console.WriteLine(dec3.ToString());
}
}
このメソッドにより、指定したOracleDecimal構造の値に値が設定され、指定された数だけ右に小数点の位置がシフトされた、新しいOracleDecimal構造を戻します。
宣言
// C# public static OracleDecimal Shift(OracleDecimal val, int decplaces);
パラメータ
val
OracleDecimal構造。
decplaces
位置をシフトする、指定された数
戻り値
OracleDecimal構造。
備考
指定したOracleDecimal構造にNULL値がある場合、戻されたOracleDecimalにはNULL値があります。
decplacesが負である場合、左にシフトされます。
このメソッドでは、OracleDecimal構造の符号を決定します。
宣言
// C#
public static int Sign(OracleDecimal val);
パラメータ
val
OracleDecimal構造。
戻り値
-1: 指定したOracleDecimalが<0の場合
0: 指定したOracleDecimalが==0の場合
1: 指定したOracleDecimalが>0の場合
例外
OracleNullValueException - 引数にNULL値があります。
このメソッドにより、指定したOracleDecimal構造の2乗根に値が設定された、新しいOracleDecimal構造を戻します。
宣言
// C#
public static OracleDecimal Sqrt(OracleDecimal val);
パラメータ
val
OracleDecimal構造。
戻り値
OracleDecimal構造。
例外
ArgumentOutOfRangeException - 指定されたOracleDecimal構造はゼロより小さいです。
備考
引数のいずれかにNULL値がある場合、戻されたOracleDecimalにはNULL値があります。
このメソッドにより、あるOracleDecimal構造を別の構造から引いた結果に値が設定された、新しいOracleDecimal構造を戻します。
宣言
// C# public static OracleDecimal Subtract(OracleDecimal val1, OracleDecimal val2);
パラメータ
val1
OracleDecimal構造。
val2
OracleDecimal構造。
戻り値
OracleDecimal構造。
備考
引数のいずれかにNULL値がある場合、戻されたOracleDecimalにはNULL値があります。
このメソッドにより、OracleDecimalを指定された位置で切り捨てます。
宣言
// C# public static OracleDecimal Truncate(OracleDecimal val, int pos);
パラメータ
val
OracleDecimal構造。
pos
指定された位置。値が正である場合、この機能によりOracleDecimal構造の小数点第2位を四捨五入(切り捨て)します。値が負である場合、これによりOracleDecimal構造の小数点第1位を四捨五入(切り捨て)します。
戻り値
OracleDecimal構造。
備考
指定したOracleDecimal構造にNULL値がある場合、戻されたOracleDecimalにはNULL値があります。
OracleDecimal静的(対数)メソッドを、表14-41にリストします。
表14-41 OracleDecimal静的(対数)メソッド
| メソッド | 説明 |
|---|---|
|
指定した指数に累乗したeに値が設定された、新しい |
|
|
指定した |
|
|
指定した指数に呼び出された、指定した |
このメソッドにより、指定したOracleDecimalへ累乗したeに値が設定された、新しいOracleDecimal構造を戻します。
宣言
// C#
public static OracleDecimal Exp(OracleDecimal val);
パラメータ
val
OracleDecimal構造。
戻り値
OracleDecimal構造。
備考
引数のいずれかにNULL値がある場合、戻されたOracleDecimalにはNULL値があります。
Logにより、指定したOracleDecimal構造の対数に値が設定された、指定したOracleDecimal構造を戻します。
オーバーロード・リスト:
このメソッドにより、指定したOracleDecimal構造の自然対数(ベースe)に値が設定された、新しいOracleDecimal構造を戻します。
このメソッドにより、指定したベース内の、指定したOracleDecimal構造の対数に値が設定された、指定したOracleDecimal構造を戻します。
Log(OracleDecimal, OracleDecimal)
このメソッドにより、指定したベース内の、指定したOracleDecimal構造の対数に値が設定された、指定したOracleDecimal構造を戻します。
このメソッドにより、指定したOracleDecimal構造の自然対数(ベースe)に値が設定された、新しいOracleDecimal構造を戻します。
宣言
// C#
public static OracleDecimal Log(OracleDecimal val);
パラメータ
val
対数が計算されるOracleDecimal構造
戻り値
valの自然対数(ベースe)に値が設定された、新しいOracleDecimal構造を戻します。
例外
ArgumentOutOfRangeException - 指定したOracleDecimal値はゼロより小さいです。
備考
指定したOracleDecimal構造にNULL値がある場合、戻されたOracleDecimalにはNULL値があります。
指定したOracleDecimal構造にゼロ値がある場合、結果は定義されず、戻されたOracleDecimal構造にはNULL値があります。
このメソッドにより、指定したベース内の、指定したOracleDecimal構造の対数に値が設定された、指定したOracleDecimal構造を戻します。
宣言
// C# public static OracleDecimal Log(OracleDecimal val, int logBase);
パラメータ
val
対数が計算されるOracleDecimal構造
logBase
対数のベースを指定するint
戻り値
指定したベース内のvalの対数に値が設定された、新しいOracleDecimal構造
例外
ArgumentOutOfRangeException - 引数がゼロより小さいです。
備考
引数のいずれかにNULL値がある場合、戻されたOracleDecimalにはNULL値があります。
両方の引数にゼロ値がある場合、結果は定義されず、戻されたOracleDecimal構造にはNULL値があります。
このメソッドにより、指定したベース内の、指定したOracleDecimal構造の対数に値が設定された、指定したOracleDecimal構造を戻します。
宣言
// C# public static OracleDecimal Log(OracleDecimal val, OracleDecimal logBase);
パラメータ
val
対数が計算されるOracleDecimal構造
logBase
対数のベースを指定するOracleDecimal構造
戻り値
指定したベースのvalの対数を戻します。
例外
ArgumentOutOfRangeException - valまたはlogBaseパラメータのいずれかがゼロより小さいです。
備考
引数のいずれかにNULL値がある場合、戻されたOracleDecimalにはNULL値があります。
両方の引数にゼロ値がある場合、結果は定義されず、戻されたOracleDecimal構造にはNULL値があります。
Powにより、指定した指数に呼び出された、指定したOracleDecimal構造に値が設定された、新しいOracleDecimal構造を戻します。
オーバーロード・リスト:
このメソッドにより、指定したInt32指数に呼び出された、指定したOracleDecimal値に値が設定された、新しいOracleDecimal構造を戻します。
Pow(OracleDecimal, OracleDecimal)
このメソッドにより、指定したOracleDecimal指数に呼び出された、指定したOracleDecimal構造に値が設定された、新しいOracleDecimal構造を戻します。
このメソッドにより、指定したInt32指数に呼び出された、指定したOracleDecimal値に値が設定された、新しいOracleDecimal構造を戻します。
宣言
// C# public static OracleDecimal Pow(OracleDecimal val, int power);
パラメータ
val
OracleDecimal構造。
power
指数を指定する整数
戻り値
OracleDecimal構造。
備考
指定したOracleDecimal構造にNULL値がある場合、戻されたOracleDecimalにはNULL値があります。
このメソッドにより、指定したOracleDecimal指数に呼び出された、指定したOracleDecimal構造に値が設定された、新しいOracleDecimal構造を戻します。
宣言
// C# public static OracleDecimal Pow(OracleDecimal val, OracleDecimal power);
パラメータ
val
OracleDecimal構造。
power
指数を指定するOracleDecimal構造
戻り値
OracleDecimal構造。
備考
指定したOracleDecimal構造にNULL値がある場合、戻されたOracleDecimalにはNULL値があります。
OracleDecimal静的(三角法)メソッドを、表14-42にリストします。
表14-42 OracleDecimal静的(三角法)メソッド
| メソッド | 説明 |
|---|---|
|
コサイン値が指定した |
|
|
サイン値が指定した |
|
|
タンジェント値が指定した |
|
|
タンジェントが2つの指定した |
|
|
指定した角度(ラジアン)のコサイン値を戻します |
|
|
指定した角度(ラジアン)のサイン値を戻します |
|
|
指定した角度(ラジアン)のタンジェント値を戻します |
|
|
指定した角度(ラジアン)の双曲線コサインを戻します |
|
|
指定した角度(ラジアン)の双曲線サインを戻します |
|
|
指定した角度(ラジアン)の双曲線タンジェントを戻します |
このメソッドは、コサイン値が指定したOracleDecimal構造である角度(ラジアン)を戻します。
宣言
// C#
public static OracleDecimal Acos(OracleDecimal val);
パラメータ
val
OracleDecimal構造。範囲は(-1から1)です。
戻り値
角度(ラジアン)を表すOracleDecimal構造。
備考
引数のいずれかにNULL値がある場合、戻されたOracleDecimalにはNULL値があります。
このメソッドは、サイン値が指定したOracleDecimal構造である角度(ラジアン)を戻します。
宣言
// C#
public static OracleDecimal Asin(OracleDecimal val);
パラメータ
val
OracleDecimal構造。範囲は(-1から1)です。
戻り値
角度(ラジアン)を表すOracleDecimal構造。
備考
引数のいずれかにNULL値がある場合、戻されたOracleDecimalにはNULL値があります。
このメソッドは、タンジェント値が指定したOracleDecimal構造である角度(ラジアン)を戻します
宣言
// C#
public static OracleDecimal Atan(OracleDecimal val);
パラメータ
val
OracleDecimal
戻り値
角度(ラジアン)を表すOracleDecimal構造。
備考
引数にNULL値がある場合、戻されたOracleDecimalにはNULL値があります。
このメソッドは、タンジェント値が2つの指定したOracleDecimal構造の比率である角度(ラジアン)を戻します。
宣言
// C# public static OracleDecimal Atan2(OracleDecimal val1, OracleDecimal val2);
パラメータ
val1
y座標を表すOracleDecimal構造
val2
x座標を表すOracleDecimal構造
戻り値
角度(ラジアン)を表すOracleDecimal構造。
備考
引数のいずれかにNULL値がある場合、戻されたOracleDecimalにはNULL値があります。
このメソッドは、指定した角度(ラジアン)のコサイン値を戻します。
宣言
// C#
public static OracleDecimal Cos(OracleDecimal val);
パラメータ
val
角度(ラジアン)を表すOracleDecimal構造。
戻り値
OracleDecimalインスタンス
例外
ArgumentOutOfRangeException - valパラメータは正の無限大または負の無限大です。
備考
引数のいずれかにNULL値がある場合、戻されたOracleDecimalにはNULL値があります。
このメソッドは、指定した角度(ラジアン)のサイン値を戻します。
宣言
// C#
public static OracleDecimal Sin(OracleDecimal val);
パラメータ
val
OracleDecimal構造。
戻り値
角度(ラジアン)を表すOracleDecimal構造。
例外
ArgumentOutOfRangeException - valパラメータは正の無限大または負の無限大です。
備考
引数のいずれかにNULL値がある場合、戻されたOracleDecimalにはNULL値があります。
このメソッドは、指定した角度(ラジアン)のタンジェント値を戻します。
宣言
// C#
public static OracleDecimal Tan(OracleDecimal val);
パラメータ
val
角度(ラジアン)を表すOracleDecimal構造。
戻り値
OracleDecimalインスタンス
例外
ArgumentOutOfRangeException - valパラメータは正の無限大または負の無限大です。
備考
引数のいずれかにNULL値がある場合、戻されたOracleDecimalにはNULL値があります。
このメソッドは、指定した角度(ラジアン)の双曲線コサインを戻します。
宣言
// C#
public static OracleDecimal Cosh(OracleDecimal val);
パラメータ
val
角度(ラジアン)を表すOracleDecimal構造。
戻り値
OracleDecimalインスタンス
備考
引数のいずれかにNULL値がある場合、戻されたOracleDecimalにはNULL値があります。
このメソッドは、指定した角度(ラジアン)の双曲線サインを戻します。
宣言
// C#
public static OracleDecimal Sinh(OracleDecimal val);
パラメータ
val
角度(ラジアン)を表すOracleDecimal構造。
戻り値
OracleDecimalインスタンス
備考
引数のいずれかにNULL値がある場合、戻されたOracleDecimalにはNULL値があります。
OracleDecimal静的(比較)演算子を、表14-43にリストします。
表14-43 OracleDecimal静的(比較)演算子
| 演算子 | 説明 |
|---|---|
|
2つの |
|
|
|
|
|
2つの |
|
|
2つの |
|
|
2つの |
|
|
2つの |
|
|
2つの |
|
|
2つの |
|
|
2つの |
|
|
ある |
|
|
|
|
|
2つの |
このメソッドにより、2つのOracleDecimal値を加えます。
宣言
// C# public static OracleDecimal operator + (OracleDecimal val1, OracleDecimal val2);
パラメータ
val1
最初のOracleDecimal
val2
2番目のOracleDecimal
戻り値
OracleDecimal構造。
備考
オペランドのいずれかにNULL値がある場合、戻されたOracleDecimalにはNULL値があります。
このメソッドにより、あるOracleDecimal値を別の値で割ります。
宣言
/ C# public static OracleDecimal operator / (OracleDecimal val1, OracleDecimal val2)
パラメータ
val1
最初のOracleDecimal
val2
2番目のOracleDecimal
戻り値
OracleDecimal構造。
備考
オペランドのいずれかにNULL値がある場合、戻されたOracleDecimalにはNULL値があります。
このメソッドでは、2つのOracleDecimal値が等しいかどうかを判断します。
宣言
// C# public static bool operator == (OracleDecimal val1, OracleDecimal val2);
パラメータ
val1
最初のOracleDecimal
val2
2番目のOracleDecimal
戻り値
これらの値が等しい場合はtrueを戻し、それ以外の場合はfalseを戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleDecimalは、NULL値を持つOracleDecimalより大きい値とみなされます。
NULL値を含む2つのOracleDecimalは等しくなります。
このメソッドでは、2つのOracleDecimal値のうち、最初の値が2番目の値より大きいかどうかを判断します。
宣言
// C# public static bool operator > (OracleDecimal val1, OracleDecimal val2);
パラメータ
val1
最初のOracleDecimal
val2
2番目のOracleDecimal
戻り値
2つのOracleDecimal値が等しくない場合はtrueを戻し、それ以外の場合はfalseを戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleDecimalは、NULL値を持つOracleDecimalより大きい値とみなされます。
NULL値を含む2つのOracleDecimalは等しくなります。
このメソッドでは、2つのOracleDecimal値のうち、最初の値が2番目の値以上であるかどうかを判断します。
宣言
// C# public static bool operator >= (OracleDecimal val1, OracleDecimal val2);
パラメータ
val1
最初のOracleDecimal
val2
2番目のOracleDecimal
戻り値
2つのOracleDecimal値のうち、最初の値が2番目の値以上である場合はtrueを戻し、それ以外の場合はfalseを戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleDecimalは、NULL値を持つOracleDecimalより大きい値とみなされます。
NULL値を含む2つのOracleDecimalは等しくなります。
このメソッドでは、2つのOracleDecimal値のうち、最初の値が等しくないかどうかを判断します。
宣言
// C# public static bool operator != (OracleDecimal val1, OracleDecimal val2);
パラメータ
val1
最初のOracleDecimal
val2
2番目のOracleDecimal
戻り値
2つのOracleDecimal値が等しくない場合はtrueを戻し、それ以外の場合はfalseを戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleDecimalは、NULL値を持つOracleDecimalより大きい値とみなされます。
NULL値を含む2つのOracleDecimalは等しくなります。
このメソッドでは、2つのOracleDecimal値のうち、最初の値が2番目の値より小さいかどうかを判断します。
宣言
// C# public static bool operator < (OracleDecimal val1, OracleDecimal val2);
パラメータ
val1
最初のOracleDecimal
val2
2番目のOracleDecimal
戻り値
2つのOracleDecimal値のうち、最初の値が2番目の値より小さい場合はtrueを戻し、それ以外の場合はfalseを戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleDecimalは、NULL値を持つOracleDecimalより大きい値とみなされます。
NULL値を含む2つのOracleDecimalは等しくなります。
このメソッドでは、2つのOracleDecimal値のうち、最初の値が2番目の値以下であるかどうかを判断します。
宣言
// C# public static bool operator <= (OracleDecimal val1, OracleDecimal val2);
パラメータ
val1
最初のOracleDecimal
val2
2番目のOracleDecimal
戻り値
2つのOracleDecimal値のうち、最初の値が2番目の値以下である場合はtrueを戻し、それ以外の場合はfalseを戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleDecimalは、NULL値を持つOracleDecimalより大きい値とみなされます。
NULL値を含む2つのOracleDecimalは等しくなります。
このメソッドでは、2つのOracleDecimal構造を掛けます。
宣言
// C# public static OracleDecimal operator * (OracleDecimal val1, OracleDecimal val2);
パラメータ
val1
最初のOracleDecimal
val2
2番目のOracleDecimal
戻り値
新しいOracleDecimal構造
備考
オペランドのいずれかにNULL値がある場合、戻されたOracleDecimalにはNULL値があります。
このメソッドにより、あるOracleDecimal構造を別の構造から引きます。
宣言
// C# public static OracleDecimal operator - (OracleDecimal val1, OracleDecimal val2);
パラメータ
val1
最初のOracleDecimal
val2
2番目のOracleDecimal
戻り値
新しいOracleDecimal構造
備考
オペランドのいずれかにNULL値がある場合、戻されたOracleDecimalにはNULL値があります。
このメソッドにより、指定したOracleDecimal構造を否定します。
宣言
// C#
public static OracleDecimal operator - (OracleDecimal val);
パラメータ
val
OracleDecimal
戻り値
新しいOracleDecimal構造
備考
指定したOracleDecimal構造にNULL値がある場合、戻されたOracleDecimalにはNULL値があります。
OracleDecimal静的演算子(.NETタイプからOracleDecimalへの変換)を、表14-44にリストします。
表14-44 OracleDecimal静的演算子(.NETタイプからOracleDecimalへの変換)
| 演算子 | 説明 |
|---|---|
|
インスタンス値を |
|
|
インスタンス値を |
implicit operator OracleDecimalにより、値のOracleDecimal表現を戻します。
オーバーロード・リスト:
implicit operator OracleDecimal(decimal)
このメソッドにより、decimal値のOracleDecimal表現を戻します。
implicit operator OracleDecimal(int)
このメソッドにより、整数のOracleDecimal表現を戻します。
implicit operator OracleDecimal(long)
このメソッドにより、long値のOracleDecimal表現を戻します。
このメソッドにより、decimal値のOracleDecimal表現を戻します。
宣言
// C#
public static implicit operator OracleDecimal(decimal val);
パラメータ
val
decimal値
戻り値
OracleDecimal
このメソッドにより、整数のOracleDecimal表現を戻します。
宣言
// C#
public static implicit operator OracleDecimal(int val);
パラメータ
val
整数
戻り値
OracleDecimal
このメソッドにより、long値のOracleDecimal表現を戻します。
宣言
// C#
public static implicit operator OracleDecimal(long val);
パラメータ
val
long値
戻り値
OracleDecimal
OracleDecimalにより、値のOracleDecimal表現を戻します。
オーバーロード・リスト:
explicit operator OracleDecimal(double)
このメソッドにより、double型のOracleDecimal表現を戻します。
explicit operator OracleDecimal(string)
このメソッドにより、文字列のOracleDecimal表現を戻します。
このメソッドにより、double型のOracleDecimal表現を戻します。
宣言
// C#
public static explicit operator OracleDecimal(double val);
パラメータ
val
double
戻り値
OracleDecimal
例外
OverFlowException - 指定したdoubleがOracleDecimalの最大値より大きいか、またはOracleDecimalの最小値より小さい値です。
備考
指定されたdouble型の値に従って、OracleDecimalには次の値が含まれます。
double.PositiveInfinity: 正の無限大値
double.NegativeInfinity: 負の無限大値。
double.NaN: NULL値
OracleDecimal静的演算子(OracleDecimalから.NETへの変換)を、表14-45にリストします。
表14-45 OracleDecimal静的演算子(OracleDecimalから.NETへの変換)
| 演算子 | 説明 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
このメソッドにより、OracleDecimal値のbyte表現を戻します。
宣言
// C#
public static explicit operator byte(OracleDecimal val);
パラメータ
val
OracleDecimal構造。
戻り値
byte
例外
OracleNullValueException - OracleDecimalにNULL値があります。
OverFlowException: byteでは指定したOracleDecimal構造を表すことができません。
このメソッドにより、OracleDecimal値のdecimal表現を戻します。
宣言
// C#
public static explicit operator decimal(OracleDecimal val);
パラメータ
val
OracleDecimal構造。
戻り値
decimal
例外
OracleNullValueException - OracleDecimalにNULL値があります。
OverFlowException - decimalでは指定したOracleDecimal構造を表すことができません。
このメソッドにより、OracleDecimal値のdouble表現を戻します。
宣言
// C#
public static explicit operator double(OracleDecimal val);
パラメータ
val
OracleDecimal構造。
戻り値
double
例外
OracleNullValueException - OracleDecimalにNULL値があります。
OverFlowException - doubleでは指定したOracleDecimal構造を表すことができません。
このメソッドにより、OracleDecimal値のshort表現を戻します。
宣言
// C#
public static explicit operator short(OracleDecimal val);
パラメータ
val
OracleDecimal構造。
戻り値
short
例外
OracleNullValueException - OracleDecimalにNULL値があります。
OverFlowException - shortでは指定したOracleDecimal構造を表すことができません。
このメソッドにより、OracleDecimal値のint表現を戻します。
宣言
// C#
public static explicit operator int(OracleDecimal val);
パラメータ
val
OracleDecimal構造。
戻り値
int
例外
OracleNullValueException - OracleDecimalにNULL値があります。
OverFlowException - intでは指定したOracleDecimal構造を表すことができません。
このメソッドにより、OracleDecimal値のlong表現を戻します。
宣言
// C#
public static explicit operator long(OracleDecimal val);
パラメータ
val
OracleDecimal構造。
戻り値
long
例外
OracleNullValueException - OracleDecimalにNULL値があります。
OverFlowException - longでは指定したOracleDecimal構造を表すことができません。
OracleDecimalプロパティを、表14-46にリストします。
表14-46 OracleDecimalプロパティ
| プロパティ | 説明 |
|---|---|
|
Oracleの内部書式におけるOracle |
|
|
|
|
|
現行インスタンスが整数であるかどうかを示します |
|
|
現行インスタンスにNULL値があるかどうかを示します |
|
|
現行インスタンスが |
|
|
現行インスタンスに |
|
|
|
このプロパティにより、内部Oracle書式でOracle NUMBERを表すバイト配列を戻します。
宣言
// C#
public byte[] BinData {get;}
プロパティ値
内部Oracle書式でOracle NUMBERを表すバイト配列
例外
OracleNullValueException - 現行インスタンスにはNULL値があります。
このプロパティではToString()の書式を指定します。
宣言
// C#
public string Format {get; set;}
プロパティ値
書式を指定する文字列
備考
ToString()がOracleDecimalのインスタンス上で呼び出されるときにFormatが使用されます。特定の通貨記号、グループ、または文字列の一部としての小数点セパレータを、ToString()メソッドで必要とする場合にこれは役立ちます。
デフォルトでは、このプロパティは、特別な書式が使用されていないことを示すnullです。
小数点およびグループ・セパレータはスレッドのOracleGlobalization.NumericCharactersによって指定されます。
通貨記号は次のスレッドのプロパティによって指定されます。
OracleGlobalization.Currency
OracleGlobalization.ISOCurrency
OracleGlobalization.DualCurrency
このプロパティは現行インスタンスが整数値であるかどうかを示します。
宣言
// C#
public bool IsInt {get;}
プロパティ値
現行インスタンスが整数値である場合はtrueを戻し、それ以外の場合はfalseを戻すbool値
例外
OracleNullValueException - 現行インスタンスにはNULL値があります。
このプロパティは現行インスタンスにNULL値があるかどうかを示します。
宣言
// C#
public bool IsNull {get;}
プロパティ値
現行インスタンスにNULL値がある場合はtrueを戻し、それ以外の場合はfalseを戻すbool値
このプロパティでは、現行インスタンスの値が0より大きいかどうかを示します。
宣言
// C#
public bool IsPositive {get;}
プロパティ値
現行インスタンスが0より大きい場合はtrueを戻し、それ以外の場合はfalseを戻すbool値
例外
OracleNullValueException - 現行インスタンスにはNULL値があります。
このプロパティは現行インスタンスにゼロの値があるかどうかを示します。
宣言
// C#
public bool IsZero{get;}
プロパティ値
現行インスタンスにゼロの値がある場合はtrueを戻し、それ以外の場合はfalseを戻すbool値
例外
OracleNullValueException - 現行インスタンスにはNULL値があります。
このメソッドにより、decimal値を戻します。
宣言
// C#
public decimal Value {get;}
プロパティ値
decimal値
例外
OracleNullValueException - 現行インスタンスにはNULL値があります。
OverFlowException - decimalでは指定したOracleDecimal構造を表すことができません。
備考
decimal値がOracleDecimalから取得されると精度が失われる可能性があります。詳細は、「OracleDecimal構造」の備考を参照してください。
OracleDecimalインスタンス・メソッドを、表14-47にリストします。
表14-47 OracleDecimalインスタンス・メソッド
| メソッド | 説明 |
|---|---|
|
現行インスタンスを指定したオブジェクトと比較し、相対値を表す整数を戻します |
|
|
オブジェクトが |
|
|
現行インスタンスのハッシュ・コードを戻します |
|
|
GetType |
|
|
現行インスタンスの |
|
|
現行インスタンスの |
|
|
現行インスタンスの |
|
|
現行インスタンスの |
|
|
現行インスタンスの |
|
|
現行インスタンスの |
|
|
現行インスタンスの |
このメソッドにより、現行インスタンスと指定したオブジェクトを比較し、その相対値を表す整数を戻します。
宣言
// C#
public int CompareTo(object obj);
パラメータ
obj
指定したインスタンス
戻り値
このメソッドでは次の数値が戻されます。
ゼロ未満: 現行インスタンスの値がobjより小さい場合
ゼロ: 現行インスタンスの値がobjと等しい場合
ゼロ超過: 現行インスタンスの値がobjより大きい場合
実装
IComparable
例外
ArgumentException - パラメータはタイプOracleDecimalではありません。
備考
次のルールが、このメソッドの動作に適用されます。
比較はOracleDecimal間で行う必要があります。たとえば、OracleDecimalインスタンスとOracleBinaryインスタンスを比較することはできません。OracleDecimalを異なるタイプと比較すると、ArgumentExceptionが表示されます。
値を持つすべてのOracleDecimalは、NULL値を持つOracleDecimalより大きい値とみなされます。
NULL値を含む2つのOracleDecimalは等しくなります。
Objectをオーバーライドします。
このメソッドは、オブジェクトがOracleDecimalのインスタンスであるかどうか、およびオブジェクトの値が現行インスタンスと等しいかどうかを判別します。
宣言
// C#
public override bool Equals(object obj);
パラメータ
obj
OracleDecimalインスタンス
戻り値
objがOracleDecimalのインスタンスである場合、およびobjの値が現行インスタンスと等しい場合はtrueを戻し、それ以外の場合はfalseを戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleDecimalは、NULL値を持つOracleDecimalより大きい値とみなされます。
NULL値を含む2つのOracleDecimalは等しくなります。
Objectをオーバーライドします。
このメソッドにより、現行インスタンスのハッシュ・コードを戻します。
宣言
// C# public override int GetHashCode();
戻り値
ハッシュ・コードを戻します。
このメソッドにより、現行インスタンスのbyte表現を戻します。
宣言
// C# public byte ToByte();
戻り値
byte
例外
OverFlowException - byteでは現行インスタンスを表すことができません。
OracleNullValueException - 現行インスタンスにはNULL値があります。
このメソッドにより、現行インスタンスのdouble表現を戻します。
宣言
// C# public double ToDouble();
戻り値
double
例外
OverFlowException - doubleでは現行インスタンスを表すことができません。
OracleNullValueException - 現行インスタンスにはNULL値があります。
このメソッドにより、現行インスタンスのInt16表現を戻します。
宣言
// C# public short ToInt16();
戻り値
short
例外
OverFlowException - shortでは現行インスタンスを表すことができません。
OracleNullValueException - 現行インスタンスにはNULL値があります。
このメソッドにより、現行インスタンスのInt32表現を戻します。
宣言
// C# public int ToInt32();
戻り値
int
例外
OverFlowException - intでは現行インスタンスを表すことができません。
OracleNullValueException - 現行インスタンスにはNULL値があります。
このメソッドにより、現行インスタンスのInt64表現を戻します。
宣言
// C# public long ToInt64();
戻り値
long
例外
OverFlowException - longでは現行インスタンスを表すことができません。
OracleNullValueException - 現行インスタンスにはNULL値があります。
このメソッドにより、現行インスタンスのSingle表現を戻します。
宣言
// C# public float ToSingle();
戻り値
float
例外
OverFlowException - floatでは現行インスタンスを表すことができません。
OracleNullValueException - 現行インスタンスにはNULL値があります。
Objectをオーバーライドします。
このメソッドにより、現行インスタンスのstring表現を戻します。
宣言
// C# public override string ToString();
戻り値
数値を文字列で戻します。
備考
現行インスタンスにNULL値がある場合、戻される文字列は「null」です。
戻される値は、Formatプロパティによって指定された数値書式における、OracleDecimalの文字列表現です。
小数点およびグループ・セパレータはスレッドのOracleGlobalization.NumericCharactersによって指定されます。
通貨記号は次のスレッドのプロパティによって指定されます。
OracleGlobalization.Currency
OracleGlobalization.ISOCurrency
OracleGlobalization.DualCurrency
数値書式が指定されていない場合、Oracleのデフォルト値が使用されます。
