ヘッダーをスキップ

Oracle® Data Provider for .NET開発者ガイド
リリース9.2.0.4

部品番号 B13807-01
Go To Table Of Contents
目次
Go To Index
索引

Go to previous page Go to beginning of chapter Go to next page

Oracle.DataAccess.Typesネームスペース(ODP.NET型)、2/19


OracleBinary構造体

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のメンバーを次の表に示します。

OracleBinaryのコンストラクタ

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

表5-1 OracleBinaryのコンストラクタ
コンストラクタ 説明

OracleBinaryのコンストラクタ

OracleBinary構造体の新規インスタンスをインスタンス化します。

OracleBinaryのstaticフィールド

OracleBinaryのstaticフィールドを表5-2に示します。

表5-2 OracleBinaryのstaticフィールド
フィールド 説明

Null

OracleBinary構造体のインスタンスに割り当てられるnull値を表します。

OracleBinaryのstaticメソッド

OracleBinaryのstaticメソッドを表5-3に示します。

表5-3 OracleBinaryのstaticメソッド
メソッド 説明

Concat

2つのOracleBinary構造体を連結した結果を返します。

Equals

2つのOracleBinary値が等しいかどうかを判断します(オーバーロード)。

GreaterThan

2つのOracleBinary値の1つ目の値が2つ目の値より大きいかどうかを判断します。

GreaterThanOrEqual

2つのOracleBinary値の1つ目の値が2つ目の値以上かどうかを判断します。

LessThan

2つのOracleBinary値の1つ目の値が2つ目の値より小さいかどうかを判断します。

LessThanOrEqual

2つのOracleBinary値の1つ目の値が2つ目の値以下かどうかを判断します。

NotEquals

2つのOracleBinary値が等しくないかどうかを判断します。

OracleBinaryのstatic演算子

OracleBinaryのstatic演算子を表5-4に示します。

表5-4 OracleBinaryのstatic演算子
演算子 説明

operator +

2つのOracleBinary値を連結します。

operator ==

2つのOracleBinary値が等しいかどうかを判断します。

operator >

2つのOracleBinary値の1つ目の値が2つ目の値より大きいかどうかを判断します。

operator >=

2つのOracleBinary値の1つ目の値が2つ目の値以上かどうかを判断します。

operator !=

2つのOracleBinary値が等しくないかどうかを判断します。

operator <

2つのOracleBinary値の1つ目の値が2つ目の値より小さいかどうかを判断します。

operator <=

2つのOracleBinary値の1つ目の値が2つ目の値以下かどうかを判断します。

OracleBinaryのstatic型変換演算子

OracleBinaryのstatic型変換演算子を表5-5に示します。

表5-5 OracleBinaryのstatic型変換演算子
演算子 説明

explicit operator byte[ ]

インスタンス値をバイト配列に変換します。

implicit operator OracleBinary

インスタンス値をOracleBinary構造体に変換します。

OracleBinaryのプロパティ

OracleBinaryのプロパティを表5-6に示します。

表5-6 OracleBinaryのプロパティ
プロパティ 説明

IsNull

現在のインスタンスがnull値を持つかどうかを示します。

Item

インデックスを使用してOracleBinary構造体の特定のbyteを取得します。

Length

バイナリ・データの長さを返します。

Value

OracleBinary構造体に格納されているバイナリ・データを返します。

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

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

表5-7 OracleBinaryのインスタンス・メソッド
メソッド 説明

CompareTo

現在のインスタンスをオブジェクトと比較し、その相対値を表す整数を返します。

Equals

2つのオブジェクトに同じバイナリ・データが含まれているかどうかを判断します(オーバーロード)。

GetHashCode

現在のインスタンスのハッシュ・コードを返します。

GetType

Objectから継承されます。

ToString

現在のOracleBinary構造体を文字列に変換します。

関連項目:

OracleBinaryのコンストラクタ

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

宣言
// C#
public OracleBinary(byte[ ] bytes);
パラメータ

OracleBinaryのstaticフィールド

OracleBinaryのstaticフィールドを表5-8に示します。

表5-8 OracleBinaryのstaticフィールド
フィールド 説明

Null

OracleBinary構造体のインスタンスに割り当てられるnull値を表します。

関連項目:

Null

このstaticフィールドは、OracleBinary構造体のインスタンスに割り当てられるnull値を表します。

宣言
// C#
public static readonly OracleBinary Null;

関連項目:

OracleBinaryのstaticメソッド

OracleBinaryのstaticメソッドを表5-9に示します。

表5-9 OracleBinaryのstaticメソッド
メソッド 説明

Concat

2つのOracleBinary構造体を連結した結果を返します。

Equals

2つのOracleBinary値が等しいかどうかを判断します(オーバーロード)。

GreaterThan

2つのOracleBinary値の1つ目の値が2つ目の値より大きいかどうかを判断します。

GreaterThanOrEqual

2つのOracleBinary値の1つ目の値が2つ目の値以上かどうかを判断します。

LessThan

2つのOracleBinary値の1つ目の値が2つ目の値より小さいかどうかを判断します。

LessThanOrEqual

2つのOracleBinary値の1つ目の値が2つ目の値以下かどうかを判断します。

NotEquals

2つのOracleBinary値が等しくないかどうかを判断します。

関連項目:

Concat

このメソッドは、2つのOracleBinary構造体を連結した結果を返します。

宣言
// C#
public static OracleBinary Concat(OracleBinary value1, OracleBinary value2);
パラメータ
戻り値

OracleBinary

備考

いずれかの引数がnull値を持つ場合、返されるOracleBinary構造体はnull値を持ちます。

関連項目:

Equals

このメソッドは、2つのOracleBinary値が等しいかどうかを判断します。

宣言
// C#
public static bool Equals(OracleBinary value1, OracleBinary value2);
パラメータ
戻り値

2つのOracleBinary値が等しい場合、trueを返します。それ以外の場合、falseを返します。

備考

このメソッドの動作には、次の規則が適用されます。

GreaterThan

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

関連項目:

GreaterThanOrEqual

このメソッドは、2つのOracleBinary値の1つ目の値が2つ目の値以上かどうかを判断します。

宣言
// C#
public static bool GreaterThanOrEqual(OracleBinary value1, OracleBinary value2);
パラメータ
戻り値

2つのOracleBinary値の1つ目の値が2つ目の値以上の場合、trueを返します。それ以外の場合、falseを返します。

備考

このメソッドの動作には、次の規則が適用されます。

LessThan

このメソッドは、2つのOracleBinary値の1つ目の値が2つ目の値より小さいかどうかを判断します。

宣言
// C#
public static bool LessThan(OracleBinary value1, OracleBinary value2);
パラメータ
戻り値

2つのOracleBinary値の1つ目の値が2つ目の値より小さい場合、trueを返します。それ以外の場合、falseを返します。

備考

このメソッドの動作には、次の規則が適用されます。

LessThanOrEqual

このメソッドは、2つのOracleBinary値の1つ目の値が2つ目の値以下かどうかを判断します。

宣言
// C#
public static bool LessThanOrEqual(OracleBinary value1, OracleBinary value2);
パラメータ
戻り値

2つのOracleBinary値の1つ目の値が2つ目の値以下の場合、trueを返します。それ以外の場合、falseを返します。

備考

このメソッドの動作には、次の規則が適用されます。

NotEquals

このメソッドは、2つのOracleBinary値が等しくないかどうかを判断します。

宣言
// C#
public static bool NotEquals(OracleBinary value1, OracleBinary value2);
パラメータ
戻り値

2つのOracleBinary値が等しくない場合、trueを返します。それ以外の場合、falseを返します。

備考

このメソッドの動作には、次の規則が適用されます。

OracleBinaryのstatic演算子

OracleBinaryのstatic演算子を表5-10に示します。

表5-10 OracleBinaryのstatic演算子
演算子 説明

operator +

2つのOracleBinary値を連結します。

operator ==

2つのOracleBinary値が等しいかどうかを判断します。

operator >

2つのOracleBinary値の1つ目の値が2つ目の値より大きいかどうかを判断します。

operator >=

2つのOracleBinary値の1つ目の値が2つ目の値以上かどうかを判断します。

operator !=

2つのOracleBinary値が等しくないかどうかを判断します。

operator <

2つのOracleBinary値の1つ目の値が2つ目の値より小さいかどうかを判断します。

operator <=

2つのOracleBinary値の1つ目の値が2つ目の値以下かどうかを判断します。

関連項目:

operator +

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

宣言
// C#
public static OracleBinary operator + (OracleBinary value1, OracleBinary
value2);
パラメータ
戻り値

OracleBinary

備考

いずれかの引数がnull値を持つ場合、返されるOacleBinary構造体はnull値を持ちます。

関連項目:

operator ==

このメソッドは、2つのOracleBinary値が等しいかどうかを判断します。

宣言
// C#
public static bool operator == (OracleBinary value1, OracleBinary value2);
パラメータ
戻り値

両方の値が同じ場合、trueを返します。それ以外の場合、falseを返します。

備考

このメソッドの動作には、次の規則が適用されます。

operator >

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

関連項目:

operator >=

このメソッドは、2つのOracleBinary値の1つ目の値が2つ目の値以上かどうかを判断します。

宣言
// C#
public static bool operator >= (OracleBinary value1, OracleBinary value2);
パラメータ
戻り値

2つのOracleBinary値の1つ目の値が2つ目の値以上の場合、trueを返します。それ以外の場合、falseを返します。

備考

このメソッドの動作には、次の規則が適用されます。

operator !=

このメソッドは、2つのOracleBinary値が等しくないかどうかを判断します。

宣言
// C#
public static bool operator != (OracleBinary value1, OracleBinary value2);
パラメータ
戻り値

2つのOracleBinary値が等しくない場合、trueを返します。それ以外の場合、falseを返します。

関連項目:

operator <

このメソッドは、2つのOracleBinary値の1つ目の値が2つ目の値より小さいかどうかを判断します。

宣言
// C#
public static bool operator < ( OracleBinary value1, OracleBinary value2);
パラメータ
戻り値

2つのOracleBinary値の1つ目の値が2つ目の値より小さい場合、trueを返します。それ以外の場合、falseを返します。

備考

このメソッドの動作には、次の規則が適用されます。

operator <=

このメソッドは、2つのOracleBinary値の1つ目の値が2つ目の値以下かどうかを判断します。

宣言
// C#
public static bool operator <= (OracleBinary value1, OracleBinary value1);
パラメータ
戻り値

2つのOracleBinary値の1つ目の値が2つ目の値以下の場合、trueを返します。それ以外の場合、falseを返します。

備考

このメソッドの動作には、次の規則が適用されます。

OracleBinaryのstatic型変換演算子

OracleBinaryのstatic型変換演算子を表5-11に示します。

表5-11 OracleBinaryのstatic型変換演算子
演算子 説明

explicit operator byte[ ]

インスタンス値をバイト配列に変換します。

implicit operator OracleBinary

インスタンス値をOracleBinary構造体に変換します。

関連項目:

explicit operator byte[ ]

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

宣言
// C#
public static explicit operator byte[ ] (OracleBinary val);
パラメータ
戻り値

バイト配列

例外

OracleNullValueException: OracleBinary構造体がnull値を持ちます。

関連項目:

implicit operator OracleBinary

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

宣言
// C#
public static implicit operator OracleBinary(byte[ ] bytes);
パラメータ
戻り値

OracleBinary

関連項目:

OracleBinaryのプロパティ

OracleBinaryのプロパティを表5-12に示します。

表5-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;}
プロパティ値

指定されたインデックスのbyte

例外

OracleNullValueException: 現在のインスタンスがnull値を持ちます。

// C#
OracleBinary ob1 = new OracleBinary(new byte[] {4,3,2,1});
Console.WriteLine(ob1[ob1.Length-1]); // Prints the value 1

関連項目:

Length

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

宣言
// 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

関連項目:

Value

このプロパティは、OracleBinary構造体に格納されているバイナリ・データを返します。

宣言
// C#
public byte[] Value {get;}
プロパティ値

バイナリ・データ

例外

OracleNullValueException: 現在のインスタンスがnull値を持ちます。

関連項目:

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

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

表5-13 OracleBinaryのインスタンス・メソッド
メソッド 説明

CompareTo

現在のインスタンスをオブジェクトと比較し、その相対値を表す整数を返します。

Equals

2つのオブジェクトに同じバイナリ・データが含まれているかどうかを判断します(オーバーロード)。

GetHashCode

現在のインスタンスのハッシュ・コードを返します。

GetType

Objectから継承されます。

ToString

現在のOracleBinary構造体を文字列に変換します。

関連項目:

CompareTo

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

宣言
// C#
public int CompareTo(object obj);
パラメータ
戻り値

このメソッドは、次の数値を返します。

実装

IComparable

例外

ArgumentException: パラメータがOracleBinary型ではありません。

備考

このメソッドの動作には、次の規則が適用されます。

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

関連項目:

Equals

このメソッドは、オブジェクトがOracleBinaryのインスタンスで、現在のインスタンスと同じバイナリ・データを持つかどうかを判断します。

宣言
// C#
public override bool Equals(object obj);
パラメータ
戻り値

objOracleBinaryのインスタンスで、現在のインスタンスと同じバイナリ・データを持つ場合、trueを返します。それ以外の場合、falseを返します。

備考

このメソッドの動作には、次の規則が適用されます。

GetHashCode

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

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

宣言
// C#
public override int GetHashCode();
戻り値

ハッシュを表すint

関連項目:

ToString

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

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

宣言
// C#
public override string ToString();
戻り値

string

備考

現在のOracleBinaryインスタンスがnull値を持つ場合、返される文字列はnullになります。

関連項目:


Go to previous page Go to beginning of chapter Go to next page
Oracle
Copyright © 2002, 2003 Oracle Corporation.

All Rights Reserved.
Go To Table Of Contents
目次
Go To Index
索引