| Oracle® Data Provider for .NET開発者ガイド 12c リリース1(12.1) B72971-07 |
|
 前 |
 次 |
OracleBinary構造は、データベースに格納されるか、またはデータベースから取得されるバイナリ・データの可変長ストリームを表します。
クラスの継承
System.Object
System.ValueType
Oracle.DataAccess.Types.OracleBinary
宣言
// C# public struct OracleBinary : 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.0, 4.5 |
スレッド安全性
パブリック静的メソッドはスレッドセーフですが、インスタンス・メソッドではスレッド安全性は保証されません。
例
// 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");
}
}
OracleBinaryメンバーは次の表にリスト表示されています。
OracleBinaryコンストラクタ
OracleBinaryコンストラクタを、表14-1にリストします。
OracleBinary静的フィールド
OracleBinary静的フィールドを、表14-2にリストします。
OracleBinary静的メソッド
OracleBinary静的メソッドを、表14-3にリストします。
表14-3 OracleBinary静的メソッド
| メソッド | 説明 |
|---|---|
|
2つの |
|
|
2つの |
|
|
2つの |
|
|
2つの |
|
|
2つの |
|
|
2つの |
|
|
2つの |
OracleBinary静的演算子
OracleBinary静的演算子を、表14-4にリストします。
表14-4 OracleBinary静的演算子
| 演算子 | 説明 |
|---|---|
|
2つの |
|
|
2つの |
|
|
2つの |
|
|
2つの |
|
|
2つの |
|
|
2つの |
|
|
2つの |
OracleBinary静的型変換演算子
OracleBinary静的型変換演算子を、表14-5にリストします。
OracleBinaryプロパティ
OracleBinaryプロパティを、表14-6にリストします。
表14-6 OracleBinaryプロパティ
| プロパティ | 説明 |
|---|---|
|
現行インスタンスにNULL値があるかどうかを示します |
|
|
索引を使用して |
|
|
バイナリ・データの長さを戻します |
|
|
|
OracleBinaryインスタンス・メソッド
OracleBinaryインスタンス・メソッドを、表14-7にリストします。
OracleBinaryコンストラクタでは、OracleBinary構造の新規インスタンスをインスタンス化し、その値を指定されたバイト配列に設定します。
宣言
// C#
public OracleBinary(byte[ ] bytes);
パラメータ
bytes
バイト配列
OracleBinary静的フィールドを、表14-8にリストします。
OracleBinary静的メソッドを、表14-9にリストします。
表14-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静的演算子を、表14-10にリストします。
表14-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静的型変換演算子を、表14-11にリストします。
このメソッドではOracleBinary値をバイト配列に変換します。
宣言
// C#
public static explicit operator byte[] (OracleBinary val);
パラメータ
val
OracleBinary
戻り値
バイト配列
例外
OracleNullValueException - OracleBinary構造にNULL値があります。
OracleBinaryプロパティを、表14-12にリストします。
表14-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インスタンス・メソッドを、表14-13にリストします。
表14-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
