Oracle® Data Provider for .NET開発者ガイド ODAC 12c リリース4 (12.1.0.2) for Microsoft Windows E72575-01 |
|
前 |
次 |
OracleDecimal
構造は、データベース内のOracle NUMBER
または任意のOracleの数値を表します。
クラスの継承
System.Object
System.ValueType
Oracle.DataAccess.Types.OracleDecimal
宣言
// C# public struct OracleDecimal : IComparable, INullable, IXmlSerializable
要件
プロバイダ | ODP.NET管理対象外ドライバ | ODP.NET管理対象ドライバ |
アセンブリ | Oracle.DataAccess.dll |
Oracle.ManagedDataAccess.dll |
ネームスペース | Oracle.DataAccess.Types |
Oracle.ManagedDataAccess.Types |
.NET Framework | 3.5, 4.0, 4.5, 4.6 | 4.0, 4.5, 4.6 |
スレッド安全性
パブリック静的メソッドはスレッドセーフですが、インスタンス・メソッドではスレッド安全性は保証されません。
備考
.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); } }
OracleDecimal
メンバーは次の表にリストされています。
OracleDecimalコンストラクタ
OracleDecimal
コンストラクタを、表14-40にリストします。
OracleDecimal静的フィールド
OracleDecimal
静的フィールドを、表14-41にリストします。
表14-41 OracleDecimal静的フィールド
フィールド | 説明 |
---|---|
最大精度を表す定数(38) |
|
最大の位取りを表す定数(127) |
|
この構造の最大値である、9.9…9 x 10125を表す定数 |
|
最小の位取りを表す定数(-84) |
|
この構造の最小値である、-1.0 x 10130の定数 |
|
ある負の値の定数 |
|
|
|
ある正の値の定数 |
|
数のPI値の定数 |
|
ゼロ値の定数 |
OracleDecimal静的(比較)メソッド
OracleDecimal
静的(比較)メソッドを、表14-42にリストします。
表14-42 OracleDecimal静的(比較)メソッド
メソッド | 説明 |
---|---|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
2つの |
OracleDecimal静的(操作)メソッド
OracleDecimal
静的(操作)メソッドを、表14-43にリストします。
表14-43 OracleDecimal静的(操作)メソッド
メソッド | 説明 |
---|---|
|
|
2つの |
|
指定された桁数を持つ新しい |
|
|
|
新規の精度と位取りを持つ、新しい |
|
|
|
|
|
2つの指定した |
|
2つの指定した |
|
2つの |
|
2つの |
|
指定した |
|
|
|
指定した |
|
新規に指定された精度を持つ、新しい |
|
指定した |
|
|
|
指定した |
|
ある |
|
指定された位置で |
OracleDecimal静的(対数)メソッド
OracleDecimal
静的(対数)メソッドを、表14-44にリストします。
表14-44 OracleDecimal静的(対数)メソッド
メソッド | 説明 |
---|---|
指定した指数に累乗したeに値が設定された、新しい |
|
指定した |
|
指定した指数に呼び出された、指定した |
OracleDecimal静的(三角法)メソッド
OracleDecimal
静的(三角法)メソッドを、表14-45にリストします。
表14-45 OracleDecimal静的(三角法)メソッド
メソッド | 説明 |
---|---|
コサイン値が指定した |
|
サイン値が指定した |
|
タンジェント値が指定した |
|
タンジェントが2つの指定した |
|
指定した角度(ラジアン)のコサイン値を戻します |
|
指定した角度(ラジアン)のサイン値を戻します |
|
指定した角度(ラジアン)のタンジェント値を戻します |
|
指定した角度(ラジアン)の双曲線コサインを戻します |
|
指定した角度(ラジアン)の双曲線サインを戻します |
|
指定した角度(ラジアン)の双曲線タンジェントを戻します |
OracleDecimal静的(比較)演算子
OracleDecimal
静的(比較)演算子を、表14-46にリストします。
表14-46 OracleDecimal静的(比較)演算子
演算子 | 説明 |
---|---|
2つの |
|
|
|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
ある |
|
|
|
2つの |
OracleDecimal静的演算子(.NETタイプからOracleDecimalへの変換)
OracleDecimal
静的演算子(.NETタイプからOracleDecimal
への変換)を、表14-47にリストします。
表14-47 OracleDecimal静的演算子(.NETタイプからOracleDecimalへの変換)
演算子 | 説明 |
---|---|
インスタンス値を |
|
インスタンス値を |
OracleDecimal静的演算子(OracleDecimalから.NETへの変換)
OracleDecimal
静的演算子(OracleDecimal
から.NETへの変換)を、表14-48にリストします。
表14-48 OracleDecimal静的演算子(OracleDecimalから.NETへの変換)
演算子 | 説明 |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
OracleDecimalプロパティ
OracleDecimal
プロパティを、表14-49にリストします。
表14-49 OracleDecimalプロパティ
プロパティ | 説明 |
---|---|
Oracleの内部書式におけるOracle |
|
|
|
現行インスタンスが整数であるかどうかを示します |
|
現行インスタンスにNULL値があるかどうかを示します |
|
現行インスタンスが |
|
現行インスタンスに |
|
|
OracleDecimalインスタンス・メソッド
OracleDecimal
インスタンス・メソッドを、表14-50にリストします。
表14-50 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
の最大値より大きい、または最小値より小さい値です。
input string format is incorrect
- ロケールの数値セパレータがカンマ()。
このコンストラクタでは、指定した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-51にリストします。
表14-51 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-52にリストします。
表14-52 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-53にリストします。
表14-53 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-54にリストします。
表14-54 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-55にリストします。
表14-55 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-56にリストします。
表14-56 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-57にリストします。
表14-57 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
int
値。
戻り値
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-58にリストします。
表14-58 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-59にリストします。
表14-59 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-60にリストします。
表14-60 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のデフォルト値が使用されます。