OracleBinary
構造は、データベースに格納されるか、またはデータベースから取得されるバイナリ・データの可変長ストリームを表します。
クラスの継承
System.Object
System.ValueType
Oracle.DataAccess.Types.OracleBinary
宣言
// ADO.NET 2.0: C# public struct OracleBinary : IComparable, INullable, IXmlSerializable
// ADO.NET 1.x: C#public struct OracleBinary : IComparable, INullable
スレッド安全性
パブリック静的メソッドはスレッドセーフですが、インスタンス・メソッドではスレッド安全性は保証されません。
例
// C# using System; using Oracle.DataAccess.Types; class OracleBinarySample { static void Main(string[] args) { // Initialize the OracleBinary structures OracleBinary binary1= new OracleBinary(new byte[] {1,2,3,4,5}); OracleBinary binary2 = new OracleBinary(new byte[] {1,2,3}); OracleBinary binary3 = new OracleBinary(new byte[] {4,5}); OracleBinary binary4 = binary2 + binary3; // Compare binary1 and binary4; they're equal if (binary1 == binary4) Console.WriteLine("The two OracleBinary structs are equal"); else Console.WriteLine("The two OracleBinary structs are different"); } }
要件
ネームスペース: Oracle.DataAccess.Types
アセンブリ: Oracle.DataAccess.dll
Microsoft .NET Frameworkバージョン: 1.xまたは2.0
OracleBinary
メンバーは次の表にリスト表示されています。
OracleBinaryコンストラクタ
OracleBinary
コンストラクタのリストを、表12-1に示します。
OracleBinary静的フィールド
OracleBinary
静的フィールドのリストを、表12-2に示します。
OracleBinary静的メソッド
OracleBinary
静的メソッドのリストを、表12-3に示します。
表12-3 OracleBinary静的メソッド
メソッド | 説明 |
---|---|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
2つの |
OracleBinary静的演算子
OracleBinary
静的演算子のリストを、表12-4に示します。
表12-4 OracleBinary静的演算子
演算子 | 説明 |
---|---|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
2つの |
OracleBinary静的型変換演算子
OracleBinary
静的型変換演算子のリストを、表12-5に示します。
OracleBinaryプロパティ
OracleBinary
プロパティのリストを、表12-6に示します。
表12-6 OracleBinaryプロパティ
プロパティ | 説明 |
---|---|
現行インスタンスにNULL値があるかどうかを示します |
|
索引を使用して |
|
バイナリ・データの長さを戻します |
|
|
OracleBinaryインスタンス・メソッド
OracleBinary
インスタンス・メソッドのリストを、表12-7に示します。
表12-7 OracleBinaryインスタンス・メソッド
メソッド | 説明 |
---|---|
現行のインスタンスをオブジェクトと比較し、相対値を表す整数を戻します |
|
2つのオブジェクトに同じバイナリ・データが含まれるかどうかを判別します(オーバーロード) |
|
現行インスタンスのハッシュ・コードを戻します |
|
GetType |
|
現行の |
OracleBinary
コンストラクタでは、OracleBinary
構造の新規インスタンスをインスタンス化し、その値を指定されたバイト配列に設定します。
宣言
// C#
public OracleBinary(byte[ ] bytes);
パラメータ
bytes
バイト配列
OracleBinary
静的フィールドのリストを、表12-8に示します。
この静的フィールドはOracleBinary
構造のインスタンスに割当てできるNULL値を表します。
宣言
// C# public static readonly OracleBinary Null;
OracleBinary
静的メソッドのリストを、表12-9に示します。
表12-9 OracleBinary静的メソッド
メソッド | 説明 |
---|---|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
2つの |
このメソッドは2つのOracleBinary
構造の連結を戻します。
宣言
// C# public static OracleBinary Concat(OracleBinary value1, OracleBinary value2);
パラメータ
value1
最初のOracleBinary
value2
2番目のOracleBinary
戻り値
OracleBinary
備考
引数のいずれかにNULL値がある場合、戻されたOracleBinary
構造にはNULL値が含まれています。
このメソッドでは、2つのOracleBinary
値が同じであるかどうかを判別します。
宣言
// C# public static bool Equals(OracleBinary value1, OracleBinary value2);
パラメータ
value1
最初のOracleBinary
value2
2番目のOracleBinary
戻り値
2つのOracleBinary
値が同じ場合はtrue
を戻し、それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleBinary
は、NULL値を持つOracleBinary
より大きくなります。
NULL値を含む2つのOracleBinary
は等しくなります。
このメソッドでは、2つのOracleBinary
値の最初の値が2番目の値より大きいかどうかを判別します。
宣言
// C# public static bool GreaterThan(OracleBinary value1, OracleBinary value2);
パラメータ
value1
最初のOracleBinary
value2
2番目のOracleBinary
戻り値
2つのOracleBinary
値の最初の値が2番目の値より大きい場合はtrue
を戻し、それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleBinary
は、NULL値を持つOracleBinary
より大きくなります。
NULL値を含む2つのOracleBinary
は等しくなります。
例
// C# using System; using Oracle.DataAccess.Types; class GreaterThanSample { static void Main(string[] args) { OracleBinary binary1 = OracleBinary.Null; OracleBinary binary2 = new OracleBinary(new byte[] {1}); // Compare two OracleBinary structs; binary1 < binary2 if (OracleBinary.GreaterThan(binary1, binary2)) Console.WriteLine("binary1 > binary2"); else Console.WriteLine("binary1 < binary2"); } }
このメソッドでは、2つのOracleBinary
値の最初の値が2番目の値以上であるかどうかを判別します。
宣言
// C# public static bool GreaterThanOrEqual(OracleBinary value1, OracleBinary value2);
パラメータ
value1
最初のOracleBinary
value2
2番目のOracleBinary
戻り値
2つのOracleBinary
値の最初の値が2番目の値以上の場合はtrue
を戻し、それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleBinary
は、NULL値を持つOracleBinary
より大きくなります。
NULL値を含む2つのOracleBinary
は等しくなります。
このメソッドでは、2つのOracleBinary
値の最初の値が2番目の値より小さいかどうかを判別します。
宣言
// C# public static bool LessThan(OracleBinary value1, OracleBinary value2);
パラメータ
value1
最初のOracleBinary
value2
2番目のOracleBinary
戻り値
2つのOracleBinary
値の最初の値が2番目の値より小さい場合はtrue
を戻し、それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleBinary
は、NULL値を持つOracleBinary
より大きくなります。
NULL値を含む2つのOracleBinary
は等しくなります。
このメソッドでは、2つのOracleBinary
値の最初の値が2番目の値以下かどうかを判別します。
宣言
// C# public static bool LessThanOrEqual(OracleBinary value1, OracleBinary value2);
パラメータ
value1
最初のOracleBinary
value2
2番目のOracleBinary
戻り値
2つのOracleBinary
値の最初の値が2番目の値以下の場合はtrue
を戻し、それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleBinary
は、NULL値を持つOracleBinary
より大きくなります。
NULL値を含む2つのOracleBinary
は等しくなります。
このメソッドでは、2つのOracleBinary
値が同じでないかどうかを判別します。
宣言
// C# public static bool NotEquals(OracleBinary value1, OracleBinary value2);
パラメータ
value1
最初のOracleBinary
value2
2番目のOracleBinary
戻り値
2つのOracleBinary
値が同じでない場合はtrue
を戻し、それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleBinary
は、NULL値を持つOracleBinary
より大きくなります。
NULL値を含む2つのOracleBinary
は等しくなります。
OracleBinary
静的演算子のリストを、表12-10に示します。
表12-10 OracleBinary静的演算子
演算子 | 説明 |
---|---|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
2つの |
|
2つの |
このメソッドでは、2つのOracleBinary
値を連結します。
宣言
// C# public static OracleBinary operator + (OracleBinary value1, OracleBinary value2);
パラメータ
value1
最初のOracleBinary
value2
2番目のOracleBinary
戻り値
OracleBinary
備考
引数のいずれかにNULL値がある場合、戻されたOracleBinary
構造にはNULL値が含まれています。
このメソッドでは、2つのOracleBinary
値が同じであるかどうかを判別します。
宣言
// C# public static bool operator == (OracleBinary value1, OracleBinary value2);
パラメータ
value1
最初のOracleBinary
value2
2番目のOracleBinary
戻り値
値が同じ場合はtrue
を戻し、それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleBinary
は、NULL値を持つOracleBinary
より大きくなります。
NULL値を含む2つのOracleBinary
は等しくなります。
このメソッドでは、2つのOracleBinary
値の最初の値が2番目の値より大きいかどうかを判別します。
宣言
// C# public static bool operator > (OracleBinary value1, OracleBinary value2);
パラメータ
value1
最初のOracleBinary
value2
2番目のOracleBinary
戻り値
2つのOracleBinary
値の最初の値が2番目の値より大きい場合はtrue
を戻し、それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleBinary
は、NULL値を持つOracleBinary
より大きくなります。
NULL値を含む2つのOracleBinary
は等しくなります。
例
// C# using System; using Oracle.DataAccess.Types; class OperatorSample { static void Main(string[] args) { OracleBinary binary1 = OracleBinary.Null; OracleBinary binary2 = new OracleBinary(new byte[] {1}); // Compare two OracleBinary structs; binary1 < binary2 if (binary1 > binary2) Console.WriteLine("binary1 > binary2"); else Console.WriteLine("binary1 < binary2"); } }
このメソッドでは、2つのOracleBinary
値の最初の値が2番目の値以上かどうかを判別します。
宣言
// C# public static bool operator >= (OracleBinary value1, OracleBinary value2);
パラメータ
value1
最初のOracleBinary
value2
2番目のOracleBinary
戻り値
2つのOracleBinary
値の最初の値が2番目の値以上の場合はtrue
を戻し、それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleBinary
は、NULL値を持つOracleBinary
より大きくなります。
NULL値を含む2つのOracleBinary
は等しくなります。
このメソッドでは、2つのOracleBinary
値が同じでないかどうかを判別します。
宣言
// C# public static bool operator != (OracleBinary value1, OracleBinary value2);
パラメータ
value1
最初のOracleBinary
value2
2番目のOracleBinary
戻り値
2つのOracleBinary
値が同じでない場合はtrue
を戻し、それ以外の場合はfalse
を戻します。
このメソッドでは、2つのOracleBinary
値の最初の値が2番目の値より小さいかどうかを判別します。
宣言
// C# public static bool operator < ( OracleBinary value1, OracleBinary value2);
パラメータ
value1
最初のOracleBinary
value2
2番目のOracleBinary
戻り値
2つのOracleBinary
値の最初の値が2番目の値より小さい場合はtrue
を戻し、それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleBinary
は、NULL値を持つOracleBinary
より大きくなります。
NULL値を含む2つのOracleBinary
は等しくなります。
このメソッドでは、2つのOracleBinary
値の最初の値が2番目の値以下かどうかを判別します。
宣言
// C# public static bool operator <= (OracleBinary value1, OracleBinary value1);
パラメータ
value1
最初のOracleBinary
value2
2番目のOracleBinary
戻り値
2つのOracleBinary
値の最初の値が2番目の値以下の場合はtrue
を戻し、それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleBinary
は、NULL値を持つOracleBinary
より大きくなります。
NULL値を含む2つのOracleBinary
は等しくなります。
OracleBinary
静的型変換演算子のリストを、表12-11に示します。
このメソッドではOracleBinary
値をバイト配列に変換します。
宣言
// C#
public static explicit operator byte[ ] (OracleBinary val);
パラメータ
val
OracleBinary
戻り値
バイト配列
例外
OracleNullValueException
: OracleBinary
構造にNULL値があります。
このメソッドではバイト配列をOracleBinary
構造に変換します。
宣言
// C#
public static implicit operator OracleBinary(byte[ ] bytes);
パラメータ
bytes
バイト配列
戻り値
OracleBinary
OracleBinary
プロパティのリストを、表12-12に示します。
表12-12 OracleBinaryプロパティ
プロパティ | 説明 |
---|---|
現行インスタンスにNULL値があるかどうかを示します |
|
索引を使用して |
|
バイナリ・データの長さを戻します |
|
|
このプロパティは現行インスタンスにNULL値があるかどうかを示します。
宣言
// C# public bool IsNull {get;}
プロパティ値
現行のインスタンスにNULL値がある場合はtrue
を戻し、それ以外の場合はfalse
を戻します。
このプロパティでは、索引を使用してOracleBinary
構造の特定のbyte
を取得します。
宣言
// C# public byte this[int index] {get;}
プロパティ値
指定された索引のバイト
例外
OracleNullValueException
: 現行インスタンスにはNULL値があります。
例
// C# using System; using Oracle.DataAccess.Types; class ItemSample { static void Main(string[] args) { OracleBinary binary = new OracleBinary(new byte[] {1,2,3,4}); // Prints the value 4 Console.WriteLine(binary[binary.Length - 1]); } }
このプロパティではバイナリ・データの長さを戻します。
宣言
// C# public int length {get;}
プロパティ値
バイナリ・データの長さ
例外
OracleNullValueException
: 現行インスタンスにはNULL値があります。
例
// C# using System; using Oracle.DataAccess.Types; class LengthSample { static void Main(string[] args) { OracleBinary binary = new OracleBinary(new byte[] {1,2,3,4}); // Prints the value 4 Console.WriteLine(binary.Length); } }
このプロパティではOracleBinary
構造に格納されたバイナリ・データを戻します。
宣言
// C# public byte[] Value {get;}
プロパティ値
バイナリ・データ
例外
OracleNullValueException
: 現行インスタンスにはNULL値があります。
OracleBinary
インスタンス・メソッドのリストを、表12-13に示します。
表12-13 OracleBinaryインスタンス・メソッド
メソッド | 説明 |
---|---|
現行のインスタンスをオブジェクトと比較し、相対値を表す整数を戻します |
|
2つのオブジェクトに同じバイナリ・データが含まれるかどうかを判別します(オーバーロード) |
|
現行インスタンスのハッシュ・コードを戻します |
|
GetType |
|
現行の |
このメソッドでは、現行のインスタンスとオブジェクトを比較し、相対値を表す整数を戻します。
宣言
// C#
public int CompareTo(object obj);
パラメータ
obj
比較対象のオブジェクト
戻り値
メソッドが戻す数値は次のとおりです。
ゼロ未満: 現行のOracleBinary
インスタンス値がobj
より小さい場合
ゼロ: 現行のOracleBinary
インスタンス値とobj
値のバイナリ・データが同じ場合
ゼロ超過: 現行のOracleBinary
インスタンス値がobj
より大きい場合
実装
IComparable
例外
ArgumentException
: パラメータがOracleBinary
型でない場合
備考
次のルールが、このメソッドの動作に適用されます。
比較はOracleBinary
間で行う必要があります。たとえば、OracleBinary
インスタンスとOracleTimeStamp
インスタンスを比較することはできません。OracleBinary
を他の型と比較すると、ArgumentException
が表示されます。
値を持つすべてのOracleBinary
は、NULL値を持つOracleBinary
より大きくなります。
NULL値を含む2つのOracleBinary
は等しくなります。
例
// C# using System; using Oracle.DataAccess.Types; class CompareToSample { static void Main(string[] args) { OracleBinary binary1 = new OracleBinary(new byte[] {1,2,3}); OracleBinary binary2 = new OracleBinary(new byte[] {1,2,3,4}); // Compare if (binary1.CompareTo(binary2) == 0) Console.WriteLine("binary1 is the same as binary2"); else Console.WriteLine("binary1 is different from binary2"); } }
このメソッドでは、オブジェクトがOracleBinary
のインスタンスであるかどうか、および現行のインスタンスと同じバイナリ・データかどうかを判別します。
宣言
// C#
public override bool Equals(object obj);
パラメータ
obj
比較対象のオブジェクト
戻り値
obj
がOracleBinary
のオブジェクトで、バイナリ・データが現行のインスタンスと同じ場合はtrue
を戻し、それ以外の場合はfalse
を戻します。
備考
次のルールが、このメソッドの動作に適用されます。
値を持つすべてのOracleBinary
は、NULL値を持つOracleBinary
より大きくなります。
NULL値を含む2つのOracleBinary
は等しくなります。
Object
をオーバーライドします。
このメソッドではOracleBinary
インスタンスのハッシュ・コードを戻します。
宣言
// C# public override int GetHashCode();
戻り値
ハッシュを表すint
Object
をオーバーライドします。
このメソッドではOracleBinary
インスタンスを文字列インスタンスに変換します。
宣言
// C# public override string ToString();
戻り値
string
備考
現行のOracleBinary
インスタンスにNULL値がある場合は、戻される文字列は「NULL」
です。