| Oracle® Data Provider for .NET開発者ガイド リリース9.2.0.4 部品番号 B13807-01 |
|
Oracle.DataAccess.Typesネームスペース(ODP.NET型)、4/19
OracleDecimal構造体は、データベース内のOracleのNUMBERまたは任意のOracleの数値を表します。
Object
ValueType
OracleDecimal
// C# public struct OracleDecimal : IComparable
インスタンス・メソッドではスレッド・セーフティを保証しませんが、すべてのpublic staticメソッドはスレッド・セーフです。
OracleDecimalは38精度まで格納できます。一方、.NETのDecimalデータ型は28精度までしか保持できません。28精度より大きな値を持つOracleDecimalからOracleDecimal.Valueプロパティにアクセスすると、精度が失われる場合があります。OracleDecimalの実際の値を取得するには、OracleDecimal.ToString()メソッドを使用します。もう1つの方法として、BinDataプロパティを使用し、OracleDecimal値をOracleのNUMBERの内部形式のバイト配列として取得する方法があります。
// C# // Illustrates the usage of OracleDecimal OracleDecimal pi = OracleDecimal.Pi; // Use of implicit operator OracleDecimal(int) OracleDecimal approxPi = OracleDecimal.Divide(22,7); // Round the difference to 5 decimal places OracleDecimal diff=OracleDecimal.Round(OracleDecimal.Abs(pi -approxPi),5); // Set the format for ToString() - display with trailing zeroes diff.Format = "9.9999900"; Console.WriteLine(diff.ToString());
ネームスペース: Oracle.DataAccess.Types
アセンブリ: Oracle.DataAccess.dll
OracleDecimalのメンバーを次の表に示します。
OracleDecimalのコンストラクタを表5-27に示します。
| コンストラクタ | 説明 |
|---|---|
|
OracleDecimal構造体の新規インスタンスをインスタンス化します(オーバーロード)。 |
OracleDecimalのstaticフィールドを表5-28に示します。
OracleDecimalのstatic(比較)メソッドを表5-29に示します。
OracleDecimalのstatic(操作)メソッドを表5-30に示します。
OracleDecimalのstatic(対数)メソッドを表5-31に示します。
OracleDecimalのstatic(三角法)メソッドを表5-32に示します。
OracleDecimalのstatic(比較)演算子を表5-33に示します。
OracleDecimalのstatic演算子(.NET型からOracleDecimalへの変換)を表5-34に示します。
| 演算子 | 説明 |
|---|---|
|
インスタンス値を |
|
|
インスタンス値を |
OracleDecimalのstatic演算子(OracleDecimalから.NET型への変換)を表5-35に示します。
OracleDecimalのプロパティを表5-36に示します。
| プロパティ | 説明 |
|---|---|
|
Oracleの |
|
|
|
|
|
現在のインスタンスが整数かどうかを示します。 |
|
|
現在のインスタンスがnull値を持つかどうかを示します。 |
|
|
現在のインスタンスが |
|
|
現在のインスタンスが |
|
|
|
OracleDecimalのインスタンス・メソッドを表5-37に示します。
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);
ArgumentException: bytesパラメータがOracleのNUMBERの内部形式ではないか、無効な値を持ちます。
ArgumentNullException: bytesパラメータがnullです。
このコンストラクタは、OracleDecimal構造体の新規インスタンスを作成し、指定されたDecimal値にその値を設定します。
// C# public OracleDecimal(decimal decX);
このコンストラクタは、OracleDecimal構造体の新規インスタンスを作成し、指定されたdouble値にその値を設定します。
// C# public OracleDecimal(double doubleX)
OverFlowException: 指定されたdouble値がOracleDecimalの最大値より大きい、またはOracleDecimalの最小値より小さいです。
OracleDecimalには、指定されたdouble値に応じて次の値が含まれます。
このコンストラクタは、OracleDecimal構造体の新規インスタンスを作成し、指定されたInt32値にその値を設定します。
// C# public OracleDecimal(int intX);
このコンストラクタは、OracleDecimal構造体の新規インスタンスを作成し、指定されたSingle値にその値を設定します。
// C# public OracleDecimal(float floatX);
OracleDecimalには、指定されたfloatの値に応じて次の値が含まれます。
float.PositiveInfinity: 正の無限大値
float.NegativeInfinity: 負の無限大値
float.NaN: null値
このコンストラクタは、OracleDecimal構造体の新規インスタンスを作成し、指定されたInt64値にその値を設定します。
// C# public OracleDecimal(long longX);
このコンストラクタは、OracleDecimal構造体の新規インスタンスを作成し、指定されたstring値にその値を設定します。
// C# public OracleDecimal(string numStr);
ArgumentException: numStrパラメータが無効な文字列表現のOracleDecimalです。
ArgumentNullException: numStrパラメータがnullです。
OverFlowException: numStrの値がOracleDecimalの最大値より大きい、またはOracleDecimalの最小値より小さいです。
このコンストラクタは、指定されたstring値および数値書式を使用してOracleDecimal構造体の新規インスタンスを作成します。
// C# public OracleDecimal(string numStr, string format);
ArgumentException: numStrパラメータが無効な文字列表現のOracleDecimalであるか、formatによって指定された数値書式ではありません。
ArgumentNullException: numStrパラメータがnullです。
OverFlowException: numStrパラメータの値がOracleDecimalの最大値より大きい、またはOracleDecimalの最小値より小さいです。
数値書式に小数区切りおよびグループ・セパレータが含まれる場合、指定された文字列では、スレッドのOracleGlobalization.NumericCharactersによって定義された文字が必ず使用されます。
数値書式に通貨記号、ISO通貨記号または二重通貨記号が含まれる場合、指定された文字列では、OracleGlobalization.Currencyプロパティ、OracleGlobalization.ISOCurrencyプロパティおよびOracleGlobalization.DualCurrencyプロパティそれぞれによって定義された記号が必ず使用されます。
// C# // Set the nls parameters to be used in the numeric format OracleGlobalization og = OracleGlobalization.GetClientInfo(); og.Currency = "$"; og.NumericCharacters = ".,"; OracleGlobalization.SetThreadInfo(og); // Construct an OracleDecimal using a valid numeric format OracleDecimal od = new OracleDecimal("$2,222.22","L9G999D99"); Console.WriteLine(od.ToString()); // Prints $2,222.22
OracleDecimalのstaticフィールドを表5-38に示します。
このstaticフィールドは、最大精度を表します。最大精度は38です。
// C# public static readonly byte MaxPrecision;
このstaticフィールドは、位取りの最大値を表す定数を示します。最大値は127です。
// C# public static readonly byte MaxScale;
このstaticフィールドは、この構造体の最大値を表す定数を示します。最大値は9.9...9×10125(38個の9とそれに続く88個の0)です。
// C# public static readonly OracleDecimal MaxValue;
このstaticフィールドは、位取りの最小値を表す定数を示します。最小値は-84です。
// C# public static readonly int MinScale;
このstaticフィールドは、この構造体の最小値を表す定数を示します。最小値は-1.0×10130です。
// C# public static readonly OracleDecimal MinValue;
このstaticフィールドは、-1を表す定数を示します。
// C# public static readonly OracleDecimal NegativeOne;
このstaticフィールドは、OracleDecimalインスタンスに割り当てられるnull値を表します。
// C# public static readonly OracleDecimal Null;
このstaticフィールドは、1を表す定数を示します。
// C# public static readonly OracleDecimal One;
このstaticフィールドは、数値のπを表す定数を示します。
// C# public static readonly OracleDecimal Pi;
このstaticフィールドは、0を表す定数を示します。
// C# public static readonly OracleDecimal Zero;
OracleDecimalのstatic(比較)メソッドを表5-39に示します。
このメソッドは、2つのOracleDecimal値が等しいかどうかを判断します。
// C# public static bool Equals(OracleDecimal value1, OracleDecimal value2);
2つのOracleDecimal値が等しい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
このメソッドは、2つのOracleDecimal値の1つ目の値が2つ目の値より大きいかどうかを判断します。
// C# public static bool GreaterThan(OracleDecimal value1, OracleDecimal value2);
2つのOracleDecimal値の1つ目の値が2つ目の値より大きい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
このメソッドは、2つのOracleDecimal値の1つ目の値が2つ目の値以上かどうかを判断します。
// C# public static bool GreaterThanOrEqual(OracleDecimal value1, OracleDecimal value2);
2つのOracleDecimal値の1つ目の値が2つ目の値以上の場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
このメソッドは、2つのOracleDecimal値の1つ目の値が2つ目の値より小さいかどうかを判断します。
// C# public static bool LessThan(OracleDecimal value1, OracleDecimal value2);
2つのOracleDecimal値の1つ目の値が2つ目の値より小さい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
このメソッドは、2つのOracleDecimal値の1つ目の値が2つ目の値以下かどうかを判断します。
// C# public static bool LessThanOrEqual(OracleDecimal value1, OracleDecimal value2);
2つのOracleDecimal値の1つ目の値が2つ目の値以下の場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
このメソッドは、2つのOracleDecimal値が等しくないかどうかを判断します。
// C# public static bool NotEquals(OracleDecimal value1, OracleDecimal value2);
2つのOracleDecimal値が等しくない場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleDecimalのstatic(操作)メソッドを表5-40に示します。
このメソッドは、OracleDecimalの絶対値を返します。
// C# public static OracleDecimal Abs(OracleDecimal val);
OracleDecimalの絶対値
いずれかの引数がnull値を持つ場合、返されるOracleDecimalはnull値を持ちます。
このメソッドは、2つのOracleDecimal構造体を加算します。
// C# public static OracleDecimal Add(OracleDecimal val1, OracleDecimal val2);
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# OracleDecimal od = new OracleDecimal(5.555); // Adjust Scale to 2 with rounding off OracleDecimal odr = OracleDecimal.AdjustScale(od, 2, true); Console.WriteLine(odr.ToString()); // Prints 5.56 // Adjust Scale to 2 with truncation OracleDecimal odt = OracleDecimal.AdjustScale(od, 2, false); Console.WriteLine(odt.ToString()); // Prints 5.55
このメソッドは、指定されたOracleDecimalの上限に値が設定された新しいOracleDecimal構造体を返します。
// C# public static OracleDecimal Ceiling(OracleDecimal val);
新しいOracleDecimal構造体
いずれかの引数がnull値を持つ場合、返されるOracleDecimalはnull値を持ちます。
このメソッドは、新しい精度および位取りの新しいOracleDecimal構造体を返します。
// C# public static OracleDecimal ConvertToPrecScale(OracleDecimal val, int precision, int scale);
新しいOracleDecimal構造体
指定されたOracleDecimalがnull値を持つ場合、返されるOracleDecimalはnull値を持ちます。
// C# OracleDecimal od = new OracleDecimal(555.6666); // Set the precision of od to 5 and scale to 2 OracleDecimal odp5s2 = OracleDecimal.ConvertToPrecScale(od,5,2); Console.WriteLine(odp5s2.ToString()); // Prints 555.67 // Set the precision of od to 3 and scale to 0 OracleDecimal odp3s0 = OracleDecimal.ConvertToPrecScale(od,3,0); Console.WriteLine(odp3s0.ToString()); // Prints 556
このメソッドは、一方のOracleDecimal値を他方の値で除算します。
// C# public static OracleDecimal Divide(OracleDecimal val1, OracleDecimal val2);
新しいOracleDecimal構造体
いずれかの引数がnull値を持つ場合、返されるOracleDecimalはnull値を持ちます。
このメソッドは、指定されたOracleDecimal構造体の下限に値が設定された新しいOracleDecimal構造体を返します。
// C# public static OracleDecimal Floor(OracleDecimal val);
新しいOracleDecimal構造体
いずれかの引数がnull値を持つ場合、返されるOracleDecimalはnull値を持ちます。
このメソッドは、2つの指定されたOracleDecimal構造体の最大値を返します。
// C# public static OracleDecimal Max(OracleDecimal val1, OracleDecimal val2);
大きい方の値を持つOracleDecimal構造体
このメソッドは、2つの指定されたOracleDecimal構造体の最小値を返します。
// C# public static OracleDecimal Min(OracleDecimal val1, OracleDecimal val2);
小さい方の値を持つOracleDecimal構造体
このメソッドは、2つのOracleDecimal構造体の係数に値が設定された新しいOracleDecimal構造体を返します。
// C# public static OracleDecimal Mod(OracleDecimal val1, OracleDecimal divider);
OracleDecimal
いずれかの引数がnull値を持つ場合、返されるOracleDecimalはnull値を持ちます。
このメソッドは、2つのOracleDecimal構造体を乗算した結果に値が設定された新しいOracleDecimal構造体を返します。
// C# public static OracleDecimal Multiply(OracleDecimal val1, OracleDecimal val2);
新しいOracleDecimal構造体
いずれかの引数がnull値を持つ場合、返されるOracleDecimalはnull値を持ちます。
このメソッドは、指定されたOracleDecimal構造体の否定に値が設定された新しいOracleDecimal構造体を返します。
// C# public static OracleDecimal Negate(OracleDecimal val);
新しいOracleDecimal構造体
いずれかの引数がnull値を持つ場合、返されるOracleDecimalはnull値を持ちます。
このメソッドは、文字列をOracleDecimalに変換します。
// C# public static OracleDecimal Parse (string str);
新しいOracleDecimal構造体
ArgumentException: numStrパラメータが無効な文字列表現のOracleDecimalです。
ArgumentNullException: numStrパラメータがnullです。
OverFlowException: numStrの値がOracleDecimalの最大値より大きい、またはOracleDecimalの最小値より小さいです。
このメソッドは、指定されたOracleDecimal構造体の値を指定された位置で四捨五入した値に値が設定された新しいOracleDecimal構造体を返します。
// C# public static OracleDecimal Round(OracleDecimal val, int decplace);
val
OracleDecimal構造体。
decplace
指定された小数位。値が正の数の場合、この関数は小数点の右側でOracleDecimal構造体を四捨五入します。値が負の数の場合、この関数は小数点の左側で四捨五入します。
OracleDecimal構造体
指定されたOracleDecimal構造体がnull値を持つ場合、返されるOracleDecimalはnull値を持ちます。
このメソッドは、指定された新しい精度の新しいOracleDecimal構造体を返します。
// C# public static OracleDecimal SetPrecision(OracleDecimal val, int precision);
OracleDecimal構造体
指定された精度がvalの精度より小さい場合、返されるOracleDecimalは四捨五入されます。
valがnull値を持つ場合、返されるOracleDecimalはnull値を持ちます。
// C# OracleDecimal od = new OracleDecimal(555.6666); // Set the precision of od to 3 OracleDecimal odp3 = OracleDecimal.SetPrecision(od,3); Console.WriteLine(odp3.ToString()); // Prints 556 // Set the precision of od to 4 OracleDecimal odp4 = OracleDecimal.SetPrecision(od,4); Console.WriteLine(odp4.ToString()); // Prints 555.7
このメソッドは、指定されたOracleDecimal構造体の値から小数位を指定された桁数分だけ右にシフトした値に値が設定された新しいOracleDecimal構造体を返します。
// C# public static OracleDecimal Shift(OracleDecimal val, int decplaces);
OracleDecimal構造体
指定されたOracleDecimal構造体がnull値を持つ場合、返されるOracleDecimalはnull値を持ちます。
decplacesが負の数の場合、左側にシフトします。
このメソッドは、OracleDecimal構造体の符号を判断します。
// C# public static int Sign(OracleDecimal val);
OracleNullValueException: 引数がnull値を持ちます。
このメソッドは、指定されたOracleDecimal構造体の平方根に値が設定された新しいOracleDecimal構造体を返します。
// C# public static OracleDecimal Sqrt(OracleDecimal val);
OracleDecimal構造体
ArgumentOutOfRangeException: 指定されたOracleDecimal構造体が0より小さいです。
いずれかの引数がnull値を持つ場合、返されるOracleDecimalはnull値を持ちます。
このメソッドは、一方のOracleDecimal構造体を他方から減算した結果に値が設定された新しいOracleDecimal構造体を返します。
// C# public static OracleDecimal Subtract(OracleDecimal val1, OracleDecimal val2);
OracleDecimal構造体
いずれかの引数がnull値を持つ場合、返されるOracleDecimalはnull値を持ちます。
このメソッドは、指定された位置でOracleDecimalを切り捨てます。
// C# public static OracleDecimal Truncate(OracleDecimal val, int pos);
val
OracleDecimal構造体。
pos
指定された位置。値が正の数の場合、この関数は小数点の右側でOracleDecimal構造体を切り捨てます。値が負の数の場合、この関数は小数点の左側でOracleDecimal構造体を切り捨てます。
OracleDecimal構造体
指定されたOracleDecimal構造体がnull値を持つ場合、返されるOracleDecimalはnull値を持ちます。
OracleDecimalのstatic(対数)メソッドを表5-41に示します。
このメソッドは、指定されたOracleDecimalでeを累乗した値に値が設定された新しいOracleDecimal構造体を返します。
// C# public static OracleDecimal Exp(OracleDecimal val);
OracleDecimal構造体
いずれかの引数がnull値を持つ場合、返されるOracleDecimalはnull値を持ちます。
Logは、指定されたOracleDecimal構造体の対数に値が設定された、指定されたOracleDecimal構造体を返します。
このメソッドは、指定されたOracleDecimal構造体の自然対数(基数e)に値が設定された新しいOracleDecimal構造体を返します。
このメソッドは、指定された基数の指定されたOracleDecimal構造体の対数に値が設定された、指定されたOracleDecimal構造体を返します。
このメソッドは、指定された基数の指定されたOracleDecimal構造体の対数に値が設定された、指定されたOracleDecimal構造体を返します。
このメソッドは、指定されたOracleDecimal構造体の自然対数(基数e)に値が設定された新しいOracleDecimal構造体を返します。
// C# public static OracleDecimal Log(OracleDecimal val);
valの自然対数(基数e)に値が設定された新しいOracleDecimal構造体を返します。
ArgumentOutOfRangeException: 指定されたOracleDecimal値が0より小さいです。
指定されたOracleDecimal構造体がnull値を持つ場合、返されるOracleDecimalはnull値を持ちます。
指定されたOracleDecimal構造体が0値を持つ場合、結果は定義されません。また、返されるOracleDecimal構造体はnull値を持ちます。
このメソッドは、指定された基数の指定されたOracleDecimal構造体の対数に値が設定された、指定されたOracleDecimal構造体を返します。
// C# public static OracleDecimal Log(OracleDecimal val, int logBase);
指定された基数のvalの対数に値が設定された新しいOracleDecimal構造体
ArgumentOutOfRangeException: いずれかの引数が0より小さいです。
いずれかの引数がnull値を持つ場合、返されるOracleDecimalはnull値を持ちます。
両方の引数が0値を持つ場合、結果は定義されません。また、返されるOracleDecimal構造体はnull値を持ちます。
このメソッドは、指定された基数の指定されたOracleDecimal構造体の対数に値が設定された、指定されたOracleDecimal構造体を返します。
// C# public static OracleDecimal Log(OracleDecimal val, OracleDecimal logBase);
指定された基数のvalの対数を返します。
ArgumentOutOfRangeException: valパラメータまたはlogBaseパラメータのいずれかが0より小さいです。
いずれかの引数がnull値を持つ場合、返されるOracleDecimalはnull値を持ちます。
両方の引数が0値を持つ場合、結果は定義されません。また、返されるOracleDecimal構造体はnull値を持ちます。
Powは、指定された値で指定されたOracleDecimal構造体を累乗した値に値が設定された、新しいOracleDecimal構造体を返します。
このメソッドは、指定されたInt32の値で指定されたOracleDecimal値を累乗した値に値が設定された、新しいOracleDecimal構造体を返します。
このメソッドは、指定されたOracleDecimalの値で指定されたOracleDecimal構造体を累乗した値に値が設定された、新しいOracleDecimal構造体を返します。
このメソッドは、指定されたInt32の値で指定されたOracleDecimal値を累乗した値に値が設定された、新しいOracleDecimal構造体を返します。
// C# public static OracleDecimal Pow(OracleDecimal val, int power);
OracleDecimal構造体
指定されたOracleDecimal構造体がnull値を持つ場合、返されるOracleDecimalはnull値を持ちます。
このメソッドは、指定されたOracleDecimalの値で指定されたOracleDecimal構造体を累乗した値に値が設定された、新しいOracleDecimal構造体を返します。
// C# public static OracleDecimal Pow(OracleDecimal val, OracleDecimal power);
OracleDecimal構造体
指定されたOracleDecimal構造体がnull値を持つ場合、返されるOracleDecimalはnull値を持ちます。
OracleDecimalのstatic(三角法)メソッドを表5-42に示します。
このメソッドは、余弦が指定されたOracleDecimal構造体である角度をラジアンで返します。
// C# public static OracleDecimal Acos(OracleDecimal val);
角度をラジアンで表すOracleDecimal構造体
いずれかの引数がnull値を持つ場合、返されるOracleDecimalはnull値を持ちます。
このメソッドは、正弦が指定されたOracleDecimal構造体である角度をラジアンで返します。
// C# public static OracleDecimal Asin(OracleDecimal val);
角度をラジアンで表すOracleDecimal構造体
いずれかの引数がnull値を持つ場合、返されるOracleDecimalはnull値を持ちます。
このメソッドは、正接が指定されたOracleDecimal構造体である角度をラジアンで返します。
// C# public static OracleDecimal Atan(OracleDecimal val);
角度をラジアンで表すOracleDecimal構造体
引数がnull値を持つ場合、返されるOracleDecimalはnull値を持ちます。
このメソッドは、正接が2つの指定されたOracleDecimal構造体の商である角度をラジアンで返します。
// C# public static OracleDecimal Atan2(OracleDecimal val1, OracleDecimal val2);
角度をラジアンで表すOracleDecimal構造体
いずれかの引数がnull値を持つ場合、返されるOracleDecimalはnull値を持ちます。
このメソッドは、指定された角度(ラジアン)の余弦を返します。
// C# public static OracleDecimal Cos(OracleDecimal val);
OracleDecimalインスタンス
ArgumentOutOfRangeException: valパラメータが正または負の無限大です。
いずれかの引数がnull値を持つ場合、返されるOracleDecimalはnull値を持ちます。
このメソッドは、指定された角度(ラジアン)の正弦を返します。
// C# public static OracleDecimal Sin(OracleDecimal val);
角度をラジアンで表すOracleDecimal構造体
ArgumentOutOfRangeException: valパラメータが正または負の無限大です。
いずれかの引数がnull値を持つ場合、返されるOracleDecimalはnull値を持ちます。
このメソッドは、指定された角度(ラジアン)の正接を返します。
// C# public static OracleDecimal Tan(OracleDecimal val);
OracleDecimalインスタンス
ArgumentOutOfRangeException: valパラメータが正または負の無限大です。
いずれかの引数がnull値を持つ場合、返されるOracleDecimalはnull値を持ちます。
このメソッドは、指定された角度(ラジアン)の双曲線余弦を返します。
// C# public static OracleDecimal Cosh(OracleDecimal val);
OracleDecimalインスタンス
いずれかの引数がnull値を持つ場合、返されるOracleDecimalはnull値を持ちます。
このメソッドは、指定された角度(ラジアン)の双曲線正弦を返します。
// C# public static OracleDecimal Sinh(OracleDecimal val);
OracleDecimalインスタンス
いずれかの引数がnull値を持つ場合、返されるOracleDecimalはnull値を持ちます。
このメソッドは、指定された角度(ラジアン)の双曲線正接を返します。
// C# public static OracleDecimal Tanh(OracleDecimal val);
OracleDecimalインスタンス
いずれかの引数がnull値を持つ場合、返されるOracleDecimalはnull値を持ちます。
OracleDecimalのstatic(比較)演算子を表5-43に示します。
このメソッドは、2つのOracleDecimal値を加算します。
// C# public static OracleDecimal operator + (OracleDecimal val1, OracleDecimal val2);
OracleDecimal構造体
いずれかのオペランドがnull値を持つ場合、返されるOracleDecimalはnull値を持ちます。
このメソッドは、一方のOracleDecimal値を他方の値で除算します。
// C# public static OracleDecimal operator / (OracleDecimal val1, OracleDecimal val2);
OracleDecimal構造体
いずれかのオペランドがnull値を持つ場合、返されるOracleDecimalはnull値を持ちます。
このメソッドは、2つのOracleDecimal値が等しいかどうかを判断します。
// C# public static bool operator == (OracleDecimal val1, OracleDecimal val2);
両方の値が等しい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
このメソッドは、2つのOracleDecimal値の1つ目の値が2つ目の値より大きいかどうかを判断します。
// C# public static bool operator > (OracleDecimal val1, OracleDecimal val2);
2つのOracleDecimal値の1つ目の値が2つ目の値より大きい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
このメソッドは、2つのOracleDecimal値の1つ目の値が2つ目の値以上かどうかを判断します。
// C# public static bool operator >= (OracleDecimal val1, OracleDecimal val2);
2つのOracleDecimal値の1つ目の値が2つ目の値以上の場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
このメソッドは、2つのOracleDecimal値が等しくないかどうかを判断します。
// C# public static bool operator != (OracleDecimal val1, OracleDecimal val2);
2つのOracleDecimal値が等しくない場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
このメソッドは、2つのOracleDecimal値の1つ目の値が2つ目の値より小さいかどうかを判断します。
// C# public static bool operator < (OracleDecimal val1, OracleDecimal val2);
2つのOracleDecimal値の1つ目の値が2つ目の値より小さい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
このメソッドは、2つのOracleDecimal値の1つ目の値が2つ目の値以下かどうかを判断します。
// C# public static bool operator <= (OracleDecimal val1, OracleDecimal val2);
2つのOracleDecimal値の1つ目の値が2つ目の値以下の場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
このメソッドは、2つのOracleDecimal構造体を乗算します。
// C# public static OracleDecimal operator * (OracleDecimal val1, OracleDecimal val2);
新しいOracleDecimal構造体
いずれかのオペランドがnull値を持つ場合、返されるOracleDecimalはnull値を持ちます。
このメソッドは、一方のOracleDecimal構造体を他方から減算します。
// C# public static OracleDecimal operator - (OracleDecimal val1, OracleDecimal val2);
新しいOracleDecimal構造体
いずれかのオペランドがnull値を持つ場合、返されるOracleDecimalはnull値を持ちます。
このメソッドは、指定されたOracleDecimal構造体を否定します。
// C# public static OracleDecimal operator - (OracleDecimal val);
新しいOracleDecimal構造体
指定されたOracleDecimal構造体がnull値を持つ場合、返されるOracleDecimalはnull値を持ちます。
このメソッドは、2つのOracleDecimal構造体の係数に値が設定された新しいOracleDecimal構造体を返します。
// C# public static OracleDecimal operator % (OracleDecimal val, OracleDecimal divider);
新しいOracleDecimal構造体
いずれかのオペランドがnull値を持つ場合、返されるOracleDecimalはnull値を持ちます。
OracleDecimalのstatic演算子(.NET型からOracleDecimalへの変換)を表5-44に示します。
| 演算子 | 説明 |
|---|---|
|
インスタンス値を |
|
|
インスタンス値を |
implicit operator OracleDecimalは、OracleDecimal表現の値を返します。
このメソッドは、OracleDecimal表現のdecimal値を返します。
このメソッドは、OracleDecimal表現のint値を返します。
このメソッドは、OracleDecimal表現のlong値を返します。
このメソッドは、OracleDecimal表現のdecimal値を返します。
// C# public static implicit operator OracleDecimal(decimal val);
OracleDecimal
このメソッドは、OracleDecimal表現のint値を返します。
// C# public static implicit operator OracleDecimal(int val);
OracleDecimal
このメソッドは、OracleDecimal表現のlong値を返します。
// C# public static implicit operator OracleDecimal(long val);
OracleDecimal
explicit operator OracleDecimalは、OracleDecimal表現の値を返します。
このメソッドは、OracleDecimal表現のdoubleを返します。
このメソッドは、OracleDecimal表現のstringを返します。
このメソッドは、OracleDecimal表現のdoubleを返します。
// C# public static explicit operator OracleDecimal(double val);
OracleDecimal
OverFlowException: 指定されたdouble値がOracleDecimalの最大値より大きい、またはOracleDecimalの最小値より小さいです。
OracleDecimalには、指定されたdouble値に応じて次の値が含まれます。
このメソッドは、OracleDecimal表現のstringを返します。
// C# public static explicit operator OracleDecimal(string numStr);
OracleDecimal
ArgumentException: numStrパラメータが無効な文字列表現のOracleDecimalです。
OracleDecimalのstatic演算子(OracleDecimalから.NET型への変換)を表5-45に示します。
このメソッドは、byte表現のOracleDecimal値を返します。
// C# public static explicit operator byte(OracleDecimal val);
byte
OracleNullValueException: OracleDecimalがnull値を持ちます。
OverFlowException: byteでは指定されたOracleDecimal構造体を表すことができません。
このメソッドは、decimal表現のOracleDecimal値を返します。
// C# public static explicit operator decimal(OracleDecimal val);
decimal
OracleNullValueException: OracleDecimalがnull値を持ちます。
OverFlowException: decimalでは指定されたOracleDecimal構造体を表すことができません。
このメソッドは、double表現のOracleDecimal値を返します。
// C# public static explicit operator double(OracleDecimal val);
double
OracleNullValueException: OracleDecimalがnull値を持ちます。
OverFlowException: doubleでは指定されたOracleDecimal構造体を表すことができません。
このメソッドは、short表現のOracleDecimal値を返します。
// C# public static explicit operator short(OracleDecimal val);
short
OracleNullValueException: OracleDecimalがnull値を持ちます。
OverFlowException: shortでは指定されたOracleDecimal構造体を表すことができません。
このメソッドは、int表現のOracleDecimal値を返します。
// C# public static explicit operator int(OracleDecimal val);
int
OracleNullValueException: OracleDecimalがnull値を持ちます。
OverFlowException: intでは指定されたOracleDecimal構造体を表すことができません。
このメソッドは、long表現のOracleDecimal値を返します。
// C# public static explicit operator long(OracleDecimal val);
long
OracleNullValueException: OracleDecimalがnull値を持ちます。
OverFlowException: longでは指定されたOracleDecimal構造体を表すことができません。
このメソッドは、float表現のOracleDecimal値を返します。
// C# public static explicit operator float(OracleDecimal val);
float
OracleNullValueException: OracleDecimalがnull値を持ちます。
OverFlowException: floatでは指定されたOracleDecimal構造体を表すことができません。
OracleDecimalのプロパティを表5-46に示します。
| プロパティ | 説明 |
|---|---|
|
Oracleの |
|
|
|
|
|
現在のインスタンスが整数かどうかを示します。 |
|
|
現在のインスタンスがnull値を持つかどうかを示します。 |
|
|
現在のインスタンスが |
|
|
現在のインスタンスが |
|
|
|
このプロパティは、OracleのNUMBERをOracleの内部形式で表すバイト配列を返します。
// C# public byte[] BinData {get;}
OracleのNUMBERをOracleの内部形式で表すバイト配列
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このプロパティは、ToString()の書式を指定します。
// C# public string Format {get; set;}
書式を指定する文字列
Formatは、OracleDecimalのインスタンスでToString()がコールされる際に使用されます。ToString()メソッドで特定の通貨記号、グループ・セパレータまたは小数区切りが文字列の一部として必要な場合に便利です。
デフォルトではこのプロパティはnullで、特定の書式が使用されないことを示します。
小数区切り文字およびグループ・セパレータ文字は、スレッドのOracleGlobalization.NumericCharactersによって指定されます。
通貨記号は、次のスレッドのプロパティによって指定されます。
このプロパティは、現在のインスタンスが整数値かどうかを示します。
// 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値を持ちます。
このプロパティは、現在のインスタンスが0値を持つかどうかを示します。
// C# public bool IsZero{get;}
現在のインスタンスが0値を持つ場合にtrueを、それ以外の場合にfalseを返すbool値
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このメソッドは、decimal値を返します。
// C# public decimal Value {get;}
decimal値
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
OverFlowException: decimalでは指定されたOracleDecimal構造体を表すことができません。
decimal値がOracleDecimalから取得される際に、精度が失われる場合があります。詳細は、「OracleDecimal構造体」に記載されている備考を参照してください。
OracleDecimalのインスタンス・メソッドを表5-47に示します。
このメソッドは、現在のインスタンスを指定されたオブジェクトと比較し、その相対値を表す整数を返します。
// C# public int CompareTo(object obj);
このメソッドは、次の数値を返します。
IComparable
ArgumentException: パラメータがOracleDecimal型ではありません。
このメソッドの動作には、次の規則が適用されます。
OracleDecimal同士で行う必要があります。たとえば、OracleDecimalインスタンスとOracleBinaryインスタンスを比較することはできません。OracleDecimalを異なる型と比較すると、ArgumentExceptionがスローされます。
OracleDecimalは、null値を持つOracleDecimalより大きいことになります。
OracleDecimalがnull値を持つ場合、2つは等しいことになります。
Objectをオーバーライドします。
このメソッドは、オブジェクトがOracleDecimalのインスタンスかどうか、およびその値が現在のインスタンスと等しいかどうかを判断します。
// C# public override bool Equals(object obj);
objがOracleDecimalのインスタンスで、その値が現在のインスタンスと等しい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
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();
数値をstringで返します。
現在のインスタンスがnull値を持つ場合、返される文字列はnullです。
返される値は、Formatプロパティによって指定された数値書式の、string表現のOracleDecimalです。
小数区切り文字およびグループ・セパレータ文字は、スレッドのOracleGlobalization.NumericCharactersによって指定されます。
通貨記号は、次のスレッドのプロパティによって指定されます。
数値書式が指定されていない場合、Oracleのデフォルト値が使用されます。
|
|
![]() Copyright © 2002, 2003 Oracle Corporation. All Rights Reserved. |
|