OracleBinary構造

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

参照:

Oracle.DataAccess.Typesネームスペース
OracleBinaryメンバー
OracleBinaryコンストラクタ
OracleBinary静的フィールド
OracleBinary静的メソッド
OracleBinary静的演算子
OracleBinary静的型変換演算子
OracleBinaryプロパティ
OracleBinaryインスタンス・メソッド

OracleBinaryメンバー

OracleBinaryメンバーは次の表にリスト表示されています。

OracleBinaryコンストラクタ

OracleBinaryコンストラクタのリストを、表12-1に示します。

表12-1 OracleBinaryコンストラクタ

コンストラクタ	説明
OracleBinaryコンストラクタ	`OracleBinary`構造の新規インスタンスをインスタンス化します

OracleBinary静的フィールド

OracleBinary静的フィールドのリストを、表12-2に示します。

表12-2 OracleBinary静的フィールド

フィールド	説明
Null	`OracleBinary`構造のインスタンスに割り当てることができるNULL値を表します

OracleBinary静的メソッド

OracleBinary静的メソッドのリストを、表12-3に示します。

表12-3 OracleBinary静的メソッド

メソッド	説明
Concat	2つの`OracleBinary`構造の連結を戻します
Equals	2つの`OracleBinary`値が同じかどうかを判別します（オーバーロード）
GreaterThan	2つの`OracleBinary`値のうち、最初の値が2番目の値より大きいかどうかを判別します
GreaterThanOrEqual	2つの`OracleBinary`値のうち、最初の値が2番目の値以上かどうかを判別します
LessThan	2つの`OracleBinary`値のうち、最初の値が2番目の値より小さいかどうかを判別します
LessThanOrEqual	2つの`OracleBinary`値のうち、最初の値が2番目の値以下かどうかを判別します
NotEquals	2つの`OracleBinary`値が等しくないかどうかを判別します

OracleBinary静的演算子

OracleBinary静的演算子のリストを、表12-4に示します。

表12-4 OracleBinary静的演算子

演算子	説明
operator +	2つの`OracleBinary`値を連結します
operator ==	2つの`OracleBinary`値が等しいかどうかを判別します
operator >	2つの`OracleBinary`値のうち、最初の値が2番目の値より大きいかどうかを判別します
operator >=	2つの`OracleBinary`値のうち、最初の値が2番目の値以上かどうかを判別します
operator !=	2つの`OracleBinary`値が等しくないかどうかを判別します
operator <	2つの`OracleBinary`値のうち、最初の値が2番目の値より小さいかどうかを判別します
operator <=	2つの`OracleBinary`値のうち、最初の値が2番目の値以下かどうかを判別します

OracleBinary静的型変換演算子

OracleBinary静的型変換演算子のリストを、表12-5に示します。

表12-5 OracleBinary静的型変換演算子

演算子	説明
explicit operator byte[ ]	インスタンス値をバイト配列に変換します
implicit operator OracleBinary	インスタンス値を`OracleBinary`構造に変換します

OracleBinaryプロパティ

OracleBinaryプロパティのリストを、表12-6に示します。

表12-6 OracleBinaryプロパティ

プロパティ	説明
IsNull	現行インスタンスにNULL値があるかどうかを示します
Item	索引を使用して`OracleBinary`構造の特定の`byte`を取得します
Length	バイナリ・データの長さを戻します
Value	`OracleBinary`構造に格納されたバイナリ・データを戻します

OracleBinaryインスタンス・メソッド

OracleBinaryインスタンス・メソッドのリストを、表12-7に示します。

表12-7 OracleBinaryインスタンス・メソッド

メソッド	説明
CompareTo	現行のインスタンスをオブジェクトと比較し、相対値を表す整数を戻します
Equals	2つのオブジェクトに同じバイナリ・データが含まれるかどうかを判別します（オーバーロード）
GetHashCode	現行インスタンスのハッシュ・コードを戻します
GetType	`System.Object`からの継承
ToString	現行の`OracleBinary`構造を文字列に変換します

参照:

OracleBinaryコンストラクタ

OracleBinaryコンストラクタでは、OracleBinary構造の新規インスタンスをインスタンス化し、その値を指定されたバイト配列に設定します。

宣言

// C#
public OracleBinary(byte[ ] bytes);

パラメータ

bytes

バイト配列

参照:

OracleBinary静的フィールド

OracleBinary静的フィールドのリストを、表12-8に示します。

表12-8 OracleBinary静的フィールド

フィールド	説明
Null	`OracleBinary`構造のインスタンスに割り当てることができるNULL値を表します

参照:

Null

この静的フィールドはOracleBinary構造のインスタンスに割当てできるNULL値を表します。

宣言

// C#
public static readonly OracleBinary Null;

参照:

OracleBinary静的メソッド

OracleBinary静的メソッドのリストを、表12-9に示します。

表12-9 OracleBinary静的メソッド

メソッド	説明
Concat	2つの`OracleBinary`構造の連結を戻します
Equals	2つの`OracleBinary`値が同じかどうかを判別します（オーバーロード）
GreaterThan	2つの`OracleBinary`値のうち、最初の値が2番目の値より大きいかどうかを判別します
GreaterThanOrEqual	2つの`OracleBinary`値のうち、最初の値が2番目の値以上かどうかを判別します
LessThan	2つの`OracleBinary`値のうち、最初の値が2番目の値より小さいかどうかを判別します
LessThanOrEqual	2つの`OracleBinary`値のうち、最初の値が2番目の値以下かどうかを判別します
NotEquals	2つの`OracleBinary`値が等しくないかどうかを判別します

参照:

Concat

このメソッドは2つのOracleBinary構造の連結を戻します。

宣言

// C#
public static OracleBinary Concat(OracleBinary value1, OracleBinary value2);

パラメータ

value1

最初のOracleBinary
value2

2番目のOracleBinary

戻り値

OracleBinary

備考

引数のいずれかにNULL値がある場合、戻されたOracleBinary構造にはNULL値が含まれています。

参照:

Equals

このメソッドでは、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は等しくなります。

参照:

GreaterThan

このメソッドでは、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");
  }
}

参照:

GreaterThanOrEqual

このメソッドでは、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は等しくなります。

参照:

LessThan

このメソッドでは、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は等しくなります。

参照:

LessThanOrEqual

このメソッドでは、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は等しくなります。

参照:

NotEquals

このメソッドでは、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静的演算子

OracleBinary静的演算子のリストを、表12-10に示します。

表12-10 OracleBinary静的演算子

演算子	説明
operator +	2つの`OracleBinary`値を連結します
operator ==	2つの`OracleBinary`値が等しいかどうかを判別します
operator >	2つの`OracleBinary`値のうち、最初の値が2番目の値より大きいかどうかを判別します
operator >=	2つの`OracleBinary`値のうち、最初の値が2番目の値以上かどうかを判別します
operator !=	2つの`OracleBinary`値が等しくないかどうかを判別します
operator <	2つの`OracleBinary`値のうち、最初の値が2番目の値より小さいかどうかを判別します
operator <=	2つの`OracleBinary`値のうち、最初の値が2番目の値以下かどうかを判別します

参照:

operator +

このメソッドでは、2つのOracleBinary値を連結します。

宣言

// C#
public static OracleBinary operator + (OracleBinary value1, OracleBinary value2);

パラメータ

value1

最初のOracleBinary
value2

2番目のOracleBinary

戻り値

OracleBinary

備考

引数のいずれかにNULL値がある場合、戻されたOracleBinary構造にはNULL値が含まれています。

参照:

operator ==

このメソッドでは、2つのOracleBinary値が同じであるかどうかを判別します。

宣言

// C#
public static bool operator == (OracleBinary value1, OracleBinary value2);

パラメータ

value1

最初のOracleBinary
value2

2番目のOracleBinary

戻り値

値が同じ場合はtrueを戻し、それ以外の場合はfalseを戻します。

備考

次のルールが、このメソッドの動作に適用されます。

値を持つすべてのOracleBinaryは、NULL値を持つOracleBinaryより大きくなります。
NULL値を含む2つのOracleBinaryは等しくなります。

参照:

operator >

このメソッドでは、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");
  }
}

参照:

operator >=

このメソッドでは、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は等しくなります。

参照:

operator !=

このメソッドでは、2つのOracleBinary値が同じでないかどうかを判別します。

宣言

// C#
public static bool operator != (OracleBinary value1, OracleBinary value2);

パラメータ

value1

最初のOracleBinary
value2

2番目のOracleBinary

戻り値

2つのOracleBinary値が同じでない場合はtrueを戻し、それ以外の場合はfalseを戻します。

参照:

operator <

このメソッドでは、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は等しくなります。

参照:

operator <=

このメソッドでは、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静的型変換演算子

OracleBinary静的型変換演算子のリストを、表12-11に示します。

表12-11 OracleBinary静的型変換演算子

演算子	説明
explicit operator byte[ ]	インスタンス値をバイト配列に変換します
implicit operator OracleBinary	インスタンス値を`OracleBinary`構造に変換します

参照:

explicit operator byte[ ]

このメソッドではOracleBinary値をバイト配列に変換します。

宣言

// C#
public static explicit operator byte[ ] (OracleBinary val);

パラメータ

val

OracleBinary

戻り値

バイト配列

例外

OracleNullValueException: OracleBinary構造にNULL値があります。

参照:

implicit operator OracleBinary

このメソッドではバイト配列をOracleBinary構造に変換します。

宣言

// C#
public static implicit operator OracleBinary(byte[ ] bytes);

パラメータ

bytes

バイト配列

戻り値

OracleBinary

参照:

OracleBinaryプロパティ

OracleBinaryプロパティのリストを、表12-12に示します。

表12-12 OracleBinaryプロパティ

プロパティ	説明
IsNull	現行インスタンスにNULL値があるかどうかを示します
Item	索引を使用して`OracleBinary`構造の特定の`byte`を取得します
Length	バイナリ・データの長さを戻します
Value	`OracleBinary`構造に格納されたバイナリ・データを戻します

参照:

IsNull

このプロパティは現行インスタンスにNULL値があるかどうかを示します。

宣言

// C#
public bool IsNull {get;}

プロパティ値

現行のインスタンスにNULL値がある場合はtrueを戻し、それ以外の場合はfalseを戻します。

参照:

Item

このプロパティでは、索引を使用して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]);
  }
}

参照:

Length

このプロパティではバイナリ・データの長さを戻します。

宣言

// 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);
  }
}

参照:

Value

このプロパティではOracleBinary構造に格納されたバイナリ・データを戻します。

宣言

// C#
public byte[] Value {get;}

プロパティ値

バイナリ・データ

例外

OracleNullValueException: 現行インスタンスにはNULL値があります。

参照:

OracleBinaryインスタンス・メソッド

OracleBinaryインスタンス・メソッドのリストを、表12-13に示します。

表12-13 OracleBinaryインスタンス・メソッド

メソッド	説明
CompareTo	現行のインスタンスをオブジェクトと比較し、相対値を表す整数を戻します
Equals	2つのオブジェクトに同じバイナリ・データが含まれるかどうかを判別します（オーバーロード）
GetHashCode	現行インスタンスのハッシュ・コードを戻します
GetType	`System.Object`からの継承
ToString	現行の`OracleBinary`構造を文字列に変換します

参照:

CompareTo

このメソッドでは、現行のインスタンスとオブジェクトを比較し、相対値を表す整数を戻します。

宣言

// 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");
  }
}

参照:

Equals

このメソッドでは、オブジェクトがOracleBinaryのインスタンスであるかどうか、および現行のインスタンスと同じバイナリ・データかどうかを判別します。

宣言

// C#
public override bool Equals(object obj);

パラメータ

obj

比較対象のオブジェクト

戻り値

objがOracleBinaryのオブジェクトで、バイナリ・データが現行のインスタンスと同じ場合はtrueを戻し、それ以外の場合はfalseを戻します。

備考

次のルールが、このメソッドの動作に適用されます。

値を持つすべてのOracleBinaryは、NULL値を持つOracleBinaryより大きくなります。
NULL値を含む2つのOracleBinaryは等しくなります。

参照:

GetHashCode

Objectをオーバーライドします。

このメソッドではOracleBinaryインスタンスのハッシュ・コードを戻します。

宣言

// C#
public override int GetHashCode();

戻り値

ハッシュを表すint

参照:

ToString

Objectをオーバーライドします。

このメソッドではOracleBinaryインスタンスを文字列インスタンスに変換します。

宣言

// C#
public override string ToString();

戻り値

string

備考

現行のOracleBinaryインスタンスにNULL値がある場合は、戻される文字列は「NULL」です。

参照: