| Oracle® Data Provider for .NET開発者ガイド リリース9.2.0.4 部品番号 B13807-01 |
|
Oracle.DataAccess.Typesネームスペース(ODP.NET型)、2/19
OracleBinary構造体は、データベースに対し格納または取得される可変長ストリームのバイナリ・データを表します。
Object
ValueType
OracleBinary
// C# public struct OracleBinary : IComparable
インスタンス・メソッドではスレッド・セーフティを保証しませんが、すべてのpublic staticメソッドはスレッド・セーフです。
// C# // Concatenation of the OracleBinary values using + operator OracleBinary ob1a = new OracleBinary(new byte[] {1,2,3}); OracleBinary ob1b = new OracleBinary(new byte[] {4}); OracleBinary ob1 = ob1a + ob1b; OracleBinary ob2 = new OracleBinary(new byte[] {1,2,3,4}); // Output the length if ob1 is equal to ob2 if (ob1 == ob2) Console.WriteLine("The OracleBinary structures are equal with length " + ob1.Length);
ネームスペース: Oracle.DataAccess.Types
アセンブリ: Oracle.DataAccess.dll
OracleBinaryのメンバーを次の表に示します。
OracleBinaryのコンストラクタを表5-1に示します。
| コンストラクタ | 説明 |
|---|---|
|
|
OracleBinaryのstaticフィールドを表5-2に示します。
| フィールド | 説明 |
|---|---|
|
|
OracleBinaryのstaticメソッドを表5-3に示します。
OracleBinaryのstatic演算子を表5-4に示します。
OracleBinaryのstatic型変換演算子を表5-5に示します。
| 演算子 | 説明 |
|---|---|
|
インスタンス値をバイト配列に変換します。 |
|
|
インスタンス値を |
OracleBinaryのプロパティを表5-6に示します。
| プロパティ | 説明 |
|---|---|
|
現在のインスタンスがnull値を持つかどうかを示します。 |
|
|
インデックスを使用して |
|
|
バイナリ・データの長さを返します。 |
|
|
OracleBinary構造体に格納されているバイナリ・データを返します。 |
OracleBinaryのインスタンス・メソッドを表5-7に示します。
| メソッド | 説明 |
|---|---|
|
現在のインスタンスをオブジェクトと比較し、その相対値を表す整数を返します。 |
|
|
2つのオブジェクトに同じバイナリ・データが含まれているかどうかを判断します(オーバーロード)。 |
|
|
現在のインスタンスのハッシュ・コードを返します。 |
|
|
|
|
|
現在の |
OracleBinaryコンストラクタは、OracleBinary構造体の新規インスタンスをインスタンス化し、指定されたバイト配列にその値を設定します。
// C# public OracleBinary(byte[ ] bytes);
OracleBinaryのstaticフィールドを表5-8に示します。
| フィールド | 説明 |
|---|---|
|
|
このstaticフィールドは、OracleBinary構造体のインスタンスに割り当てられるnull値を表します。
// C# public static readonly OracleBinary Null;
OracleBinaryのstaticメソッドを表5-9に示します。
このメソッドは、2つのOracleBinary構造体を連結した結果を返します。
// C# public static OracleBinary Concat(OracleBinary value1, OracleBinary value2);
OracleBinary
いずれかの引数がnull値を持つ場合、返されるOracleBinary構造体はnull値を持ちます。
このメソッドは、2つのOracleBinary値が等しいかどうかを判断します。
// C# public static bool Equals(OracleBinary value1, OracleBinary value2);
2つのOracleBinary値が等しい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
このメソッドは、2つのOracleBinary値の1つ目の値が2つ目の値より大きいかどうかを判断します。
// C# public static bool GreaterThan(OracleBinary value1, OracleBinary value2);
2つのOracleBinary値の1つ目の値が2つ目の値より大きい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
// C# OracleBinary ob1 = OracleBinary.Null; OracleBinary ob2 = new OracleBinary(new byte[] {1}); if (OracleBinary.GreaterThan(ob2,ob1)) Console.WriteLine("ob2 > ob1");
このメソッドは、2つのOracleBinary値の1つ目の値が2つ目の値以上かどうかを判断します。
// C# public static bool GreaterThanOrEqual(OracleBinary value1, OracleBinary value2);
2つのOracleBinary値の1つ目の値が2つ目の値以上の場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
このメソッドは、2つのOracleBinary値の1つ目の値が2つ目の値より小さいかどうかを判断します。
// C# public static bool LessThan(OracleBinary value1, OracleBinary value2);
2つのOracleBinary値の1つ目の値が2つ目の値より小さい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
このメソッドは、2つのOracleBinary値の1つ目の値が2つ目の値以下かどうかを判断します。
// C# public static bool LessThanOrEqual(OracleBinary value1, OracleBinary value2);
2つのOracleBinary値の1つ目の値が2つ目の値以下の場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
このメソッドは、2つのOracleBinary値が等しくないかどうかを判断します。
// C# public static bool NotEquals(OracleBinary value1, OracleBinary value2);
2つのOracleBinary値が等しくない場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleBinaryのstatic演算子を表5-10に示します。
このメソッドは、2つのOracleBinary値を連結します。
// C# public static OracleBinary operator + (OracleBinary value1, OracleBinary value2);
OracleBinary
いずれかの引数がnull値を持つ場合、返されるOacleBinary構造体はnull値を持ちます。
このメソッドは、2つのOracleBinary値が等しいかどうかを判断します。
// C# public static bool operator == (OracleBinary value1, OracleBinary value2);
両方の値が同じ場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
このメソッドは、2つのOracleBinary値の1つ目の値が2つ目の値より大きいかどうかを判断します。
// C# public static bool operator > (OracleBinary value1, OracleBinary value2);
2つのOracleBinary値の1つ目の値が2つ目の値より大きい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
// C# OracleBinary ob1 = OracleBinary.Null; OracleBinary ob2 = new OracleBinary(new byte[] {1}); if (ob2 > ob1) Console.WriteLine("ob2 > ob1");
このメソッドは、2つのOracleBinary値の1つ目の値が2つ目の値以上かどうかを判断します。
// C# public static bool operator >= (OracleBinary value1, OracleBinary value2);
2つのOracleBinary値の1つ目の値が2つ目の値以上の場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
このメソッドは、2つのOracleBinary値が等しくないかどうかを判断します。
// C# public static bool operator != (OracleBinary value1, OracleBinary value2);
2つのOracleBinary値が等しくない場合、trueを返します。それ以外の場合、falseを返します。
このメソッドは、2つのOracleBinary値の1つ目の値が2つ目の値より小さいかどうかを判断します。
// C# public static bool operator < ( OracleBinary value1, OracleBinary value2);
2つのOracleBinary値の1つ目の値が2つ目の値より小さい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
このメソッドは、2つのOracleBinary値の1つ目の値が2つ目の値以下かどうかを判断します。
// C# public static bool operator <= (OracleBinary value1, OracleBinary value1);
2つのOracleBinary値の1つ目の値が2つ目の値以下の場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleBinaryのstatic型変換演算子を表5-11に示します。
| 演算子 | 説明 |
|---|---|
|
インスタンス値をバイト配列に変換します。 |
|
|
インスタンス値を |
このメソッドは、OracleBinary値をバイト配列に変換します。
// C# public static explicit operator byte[ ] (OracleBinary val);
バイト配列
OracleNullValueException: OracleBinary構造体がnull値を持ちます。
このメソッドは、バイト配列をOracleBinary構造体に変換します。
// C# public static implicit operator OracleBinary(byte[ ] bytes);
OracleBinary
OracleBinaryのプロパティを表5-12に示します。
| プロパティ | 説明 |
|---|---|
|
現在のインスタンスがnull値を持つかどうかを示します。 |
|
|
インデックスを使用して |
|
|
バイナリ・データの長さを返します。 |
|
|
OracleBinary構造体に格納されているバイナリ・データを返します。 |
このプロパティは、現在のインスタンスがnull値を持つかどうかを示します。
// C# public bool IsNull {get;}
現在のインスタンスがnull値を持つ場合、trueを返します。それ以外の場合、falseを返します。
このプロパティは、インデックスを使用してOracleBinary構造体の特定のbyteを取得します。
// C# public byte this[int index] {get;}
指定されたインデックスのbyte
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
// C# OracleBinary ob1 = new OracleBinary(new byte[] {4,3,2,1}); Console.WriteLine(ob1[ob1.Length-1]); // Prints the value 1
このプロパティは、バイナリ・データの長さを返します。
// C# public int length {get;}
バイナリ・データの長さ
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
// C# OracleBinary ob1 = new OracleBinary(new byte[] {4,3,2,1}); Console.WriteLine(ob1.Length); // Prints the value 4
このプロパティは、OracleBinary構造体に格納されているバイナリ・データを返します。
// C# public byte[] Value {get;}
バイナリ・データ
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
OracleBinaryのインスタンス・メソッドを表5-13に示します。
| メソッド | 説明 |
|---|---|
|
現在のインスタンスをオブジェクトと比較し、その相対値を表す整数を返します。 |
|
|
2つのオブジェクトに同じバイナリ・データが含まれているかどうかを判断します(オーバーロード)。 |
|
|
現在のインスタンスのハッシュ・コードを返します。 |
|
|
|
|
|
現在の |
このメソッドは、現在のインスタンスをオブジェクトと比較し、その相対値を表す整数を返します。
// C# public int CompareTo(object obj);
このメソッドは、次の数値を返します。
OracleBinaryインスタンス値がobjの値より小さい場合
OracleBinaryインスタンスとobjの値が同じバイナリ・データである場合
OracleBinaryインスタンス値がobjの値より大きい場合
IComparable
ArgumentException: パラメータがOracleBinary型ではありません。
このメソッドの動作には、次の規則が適用されます。
OracleBinary同士で行う必要があります。たとえば、OracleBinaryインスタンスとOracleTimeStampインスタンスを比較することはできません。OracleBinaryを異なる型と比較すると、ArgumentExceptionがスローされます。
OracleBinaryは、null値を持つOracleBinaryより大きいことになります。
OracleBinaryがnull値を持つ場合、2つは等しいことになります。
// C# OracleBinary ob1 = new OracleBinary(new byte[] {1,1,1,1}); OracleBinary ob2 = new OracleBinary(new byte[] {1}); // append to ob2 while they are not equal while (ob1.CompareTo(ob2) != 0) ob2 = ob2 + ob2; Console.WriteLine("ob1 == ob2");
このメソッドは、オブジェクトがOracleBinaryのインスタンスで、現在のインスタンスと同じバイナリ・データを持つかどうかを判断します。
// C# public override bool Equals(object obj);
objがOracleBinaryのインスタンスで、現在のインスタンスと同じバイナリ・データを持つ場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
Objectをオーバーライドします。
このメソッドは、OracleBinaryインスタンスのハッシュ・コードを返します。
// C# public override int GetHashCode();
ハッシュを表すint
Objectをオーバーライドします。
このメソッドは、OracleBinaryインスタンスを文字列のインスタンスに変換します。
// C# public override string ToString();
string
現在のOracleBinaryインスタンスがnull値を持つ場合、返される文字列はnullになります。
|
|
![]() Copyright © 2002, 2003 Oracle Corporation. All Rights Reserved. |
|