ヘッダーをスキップ

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型)、7/19


OracleString構造体

OracleString構造体は、データベースに対し格納または取得される可変長ストリームの文字を表します。

クラスの継承

Object

  ValueType

    OracleString

宣言
// C#
public struct OracleString : IComparable
スレッド・セーフティ

インスタンス・メソッドではスレッド・セーフティを保証しませんが、すべてのpublic staticメソッドはスレッド・セーフです。

// C#
// Illustrates the usage of OracleString

// bytes1 is non-Unicode encoded byte array = AAAAA
// bytes2 is Unicode encoded byte array = aa

byte[] bytes1 = new byte[] {65,65,65,65,65};
byte[] bytes2 = new byte[] {97,0,97,0};

// set str1 = AAA
// set str2 = a
OracleString str1 = new OracleString(bytes1, 0, 3, false, true);
OracleString str2 = new OracleString(bytes2, 2, 2, true, true);

// Display the constructed strings
Console.WriteLine("String str1 = " + str1.Value  +
 ". Length = " + str1.Length); // Prints String str1 = AAA. Length = 3

 Console.WriteLine("String str2 = " + str2.Value  +
   ". Length = " + str2.Length); // Prints String str2 = a. Length = 1

while (str1 > str2)
   str2 = OracleString.Concat(str2,"a");

// Display the constructed strings
Console.WriteLine("String str1 = " + str1.Value +
   ". Length = " + str1.Length); // Prints String str1 = AAA. Length= 3
Console.WriteLine("String str2 = " + str2.Value +
   ". Length = " + str2.Length); // Prints String str2 = aaa. Length= 3

要件

ネームスペース: Oracle.DataAccess.Types

アセンブリ: Oracle.DataAccess.dll

関連項目:

OracleStringのメンバー

OracleStringのメンバーを次の表に示します。

OracleStringのコンストラクタ

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

表5-74 OracleStringのコンストラクタ
コンストラクタ 説明

OracleStringのコンストラクタ

OracleString構造体の新規インスタンスをインスタンス化します(オーバーロード)。

OracleStringのstaticフィールド

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

表5-75 OracleStringのstaticフィールド
フィールド 説明

Null

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

OracleStringのstaticメソッド

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

表5-76 OracleStringのstaticメソッド
メソッド 説明

Concat

2つのOracleStringインスタンスを連結し、その結果を表す新しいOracleStringインスタンスを返します。

Equals

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

GreaterThan

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

GreaterThanOrEqual

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

LessThan

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

LessThanOrEqual

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

NotEquals

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

OracleStringのstatic演算子

OracleStringのstatic演算子を表5-77に示します。

表5-77 OracleStringのstatic演算子
演算子 説明

operator +

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

operator ==

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

operator >

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

operator >=

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

operator !=

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

operator <

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

operator <=

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

OracleStringの型変換

OracleStringの型変換を表5-78に示します。

表5-78 OracleStringの型変換
演算子 説明

explicit operator string

指定されたOracleStringstringインスタンスに変換します。

implicit operator OracleString

指定されたstringOracleStringインスタンスに変換します。

OracleStringのプロパティ

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

表5-79 OracleStringのプロパティ
プロパティ 説明

IsCaseIgnored

文字列の比較を実行する際に、大/小文字を無視する必要があるかどうかを指定します。

IsNull

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

Item

インデックスを使用してOracleStringの特定の文字を取得します。

Length

OracleStringの長さを返します。

OracleStringのメソッド

OracleStringのメソッドを表5-80に示します。

表5-80 OracleStringのメソッド
メソッド 説明

Clone

現在のOracleStringインスタンスのコピーを返します。

CompareTo

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

Equals

オブジェクトが現在のOracleString構造体と同じ文字列値を持つかどうかを判断します(オーバーロード)。

GetHashCode

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

GetNonUnicodeBytes

OracleStringの内容を含むバイト配列をクライアント・キャラクタ・セット形式で返します。

GetType

Objectから継承されます。

GetUnicodeBytes

OracleStringの内容を含むバイト配列をUnicode形式で返します。

ToString

現在のOracleStringインスタンスをstringに変換します。

関連項目:

OracleStringのコンストラクタ

OracleStringのコンストラクタは、OracleString構造体の新規インスタンスを作成します。

オーバーロード一覧:

OracleString(string)

このコンストラクタは、OracleString構造体の新規インスタンスを作成し、文字列を使用してその値を設定します。

宣言
// C#
public OracleString(string data);
パラメータ

OracleString(string, bool)

このコンストラクタは、OracleString構造体の新規インスタンスを作成し、文字列を使用してその値を設定し、比較の際に大/小文字を無視するかどうかを指定します。

宣言
// C#
public OracleString(string data, bool isCaseIgnored);
パラメータ

OracleString(byte [ ], bool)

このコンストラクタは、OracleString構造体の新規インスタンスを作成し、バイト配列を使用してその値を設定し、指定されたバイト配列をUnicodeエンコードするかどうかを指定します。

宣言
// C#
public OracleString(byte[] data, bool fUnicode);
パラメータ
例外

ArgumentNullException: dataパラメータがnullです。

関連項目:

OracleString(byte [ ], bool, bool)

このコンストラクタは、OracleString構造体の新規インスタンスを作成し、バイト配列を使用してその値を設定し、指定されたバイト配列をUnicodeエンコードするかどうか、および比較の際に大/小文字を無視するかどうかを指定します。

宣言
// C#
public OracleString(byte[] data, bool fUnicode, bool isCaseIgnored);
パラメータ
例外

ArgumentNullException: dataパラメータがnullです。

関連項目:

OracleString(byte [ ], int, int, bool)

このコンストラクタは、OracleString構造体の新規インスタンスを作成し、バイト配列を使用してその値を設定し、バイト配列の開始インデックス、バイト配列からコピーするバイト数、および指定されたバイト配列をUnicodeエンコードするかどうかを指定します。

宣言
// C#
public OracleString(byte[] data, int index, int count, bool fUnicode);
パラメータ
例外

ArgumentNullException: dataパラメータがnullです。

ArgumentOutOfRangeException: countパラメータが0より小さいです。

IndexOutOfRangeException: indexパラメータがdataの長さ以上であるか、0より小さいです。

関連項目:

OracleString(byte [ ], int, int, bool, bool)

このコンストラクタは、OracleString構造体の新規インスタンスを作成し、バイト配列を使用してその値を設定し、バイト配列の開始インデックス、バイト配列からコピーするバイト数、指定されたバイト配列をUnicodeエンコードするかどうか、および比較の際に大/小文字を無視するかどうかを指定します。

宣言
// C#
public OracleString(byte[] data, int index, int count, bool fUnicode,
  bool isCaseIgnored);
パラメータ
例外

ArgumentNullException: dataパラメータがnullです。

ArgumentOutOfRangeException: countパラメータが0より小さいです。

IndexOutOfRangeException: indexパラメータがdataの長さ以上であるか、0より小さいです。

関連項目:

OracleStringのstaticフィールド

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

表5-81 OracleStringのstaticフィールド
フィールド 説明

Null

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

関連項目:

Null

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

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

関連項目:

OracleStringのstaticメソッド

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

表5-82 OracleStringのstaticメソッド
メソッド 説明

Concat

2つのOracleStringインスタンスを連結し、その結果を表す新しいOracleStringインスタンスを返します。

Equals

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

GreaterThan

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

GreaterThanOrEqual

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

LessThan

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

LessThanOrEqual

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

NotEquals

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

関連項目:

Concat

このstaticメソッドは、2つのOracleStringインスタンスを連結し、その結果を表す新しいOracleStringインスタンスを返します。

宣言
// C#
public static OracleString Concat(OracleString str1, OracleString str2);
パラメータ
戻り値

OracleString

備考

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

関連項目:

Equals

Objectをオーバーロードします。

このstaticメソッドは、2つの比較対象のOracleStringが等しいかどうかを判断します。

宣言
// C#
public static bool Equals(OracleString str1, OracleString str2);
パラメータ
戻り値

2つの比較対象のOracleStringが等しい場合、trueを返します。それ以外の場合、falseを返します。

備考

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

GreaterThan

このstaticメソッドは、2つのOracleString値の1つ目の値が2つ目の値より大きいかどうかを判断します。

宣言
// C#
public static bool GreaterThan(OracleString str1, OracleString str2);
パラメータ
戻り値

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

備考

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

GreaterThanOrEqual

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

宣言
// C#
public static bool GreaterThanOrEqual(OracleString str1, OracleString str2);
パラメータ
戻り値

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

備考

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

LessThan

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

宣言
// C#
public static bool LessThan(OracleString str1, OracleString str2);
パラメータ
戻り値

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

備考

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

LessThanOrEqual

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

宣言
// C#
public static bool LessThanOrEqual(OracleString str1, OracleString str2);
パラメータ
戻り値

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

備考

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

NotEquals

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

宣言
// C#
public static bool NotEquals(OracleString str1, OracleString str2);
パラメータ
戻り値

2つのOracleStringインスタンスが等しくない場合、trueを返します。それ以外の場合、falseを返します。

備考

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

OracleStringのstatic演算子

OracleStringのstatic演算子を表5-83に示します。

表5-83 OracleStringのstatic演算子
演算子 説明

operator +

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

operator ==

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

operator >

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

operator >=

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

operator !=

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

operator <

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

operator <=

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

関連項目:

operator +

このstatic演算子は、2つのOracleString値を連結します。

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

OracleString

備考

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

関連項目:

operator ==

このstatic演算子は、2つのOracleString値が等しいかどうかを判断します。

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

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

備考

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

operator >

このstatic演算子は、2つのOracleString値の1つ目の値が2つ目の値より大きいかどうかを判断します。

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

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

備考

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

operator >=

このstatic演算子は、2つのOracleString値の1つ目の値が2つ目の値以上かどうかを判断します。

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

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

備考

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

operator !=

このstatic演算子は、2つのOracleString値が等しくないかどうかを判断します。

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

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

備考

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

operator <

このstatic演算子は、2つのOracleStringの1つ目の値が2つ目の値より小さいかどうかを判断します。

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

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

備考

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

operator <=

このstatic演算子は、2つのOracleString値の1つ目の値が2つ目の値以下かどうかを判断します。

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

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

備考

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

OracleStringの型変換

OracleStringの型変換を表5-84に示します。

表5-84 OracleStringの型変換
演算子 説明

explicit operator string

指定されたOracleStringstringインスタンスに変換します。

implicit operator OracleString

指定されたstringOracleStringインスタンスに変換します。

関連項目:

explicit operator string

この型変換演算子は、指定されたOracleStringstringに変換します。

宣言
//C#
public static explicit operator string (OracleString value1);
パラメータ
戻り値

string

例外

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

関連項目:

implicit operator OracleString

この型変換演算子は、指定されたstringOracleStringに変換します。

宣言
// C#
public static implicit operator OracleString (string value1);
パラメータ
戻り値

OracleString

関連項目:

OracleStringのプロパティ

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

表5-85 OracleStringのプロパティ
プロパティ 説明

IsCaseIgnored

文字列の比較を実行する際に、大/小文字を無視する必要があるかどうかを指定します。

IsNull

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

Item

インデックスを使用してOracleStringの特定の文字を取得します。

Length

OracleStringの長さを返します。

関連項目:

IsCaseIgnored

このプロパティは、文字列の比較を実行する際に、大/小文字を無視する必要があるかどうかを指定します。

宣言
//C#
public bool IsCaseIgnored {get;set;}
プロパティ値

文字列の比較の際に大/小文字を無視する必要がある場合、trueを返します。それ以外の場合、falseを返します。

備考

デフォルト値はtrueです。

// C#
OracleString str1 = new OracleString("aAaAa");
OracleString str2 = new OracleString("AaAaA");

str1.IsCaseIgnored = true;
str2.IsCaseIgnored = true;

Console.WriteLine(str1.CompareTo(str2)); // Prints 0

// Note that IsCaseIgnored must be set to false for both OracleStrings
// otherwise an exception is thrown

str1.IsCaseIgnored = false;
str2.IsCaseIgnored = false;

Console.WriteLine(str1.CompareTo(str2)); // Prints non zero value

関連項目:

IsNull

このプロパティは、現在のインスタンスがnull値を持つかどうかを示します。

宣言
// C#
public bool IsNull {get;}
プロパティ値

現在のインスタンスがnull値を持つ場合、trueを返します。それ以外の場合、falseを返します。

関連項目:

Item

このプロパティは、インデックスを使用してOracleStringの特定の文字を取得します。

宣言
// C#
public char Item {get;}
プロパティ値

char

例外

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

関連項目:

Length

このプロパティは、OracleStringの長さを返します。

宣言
// C#
public int Length {get;}
プロパティ値

int

例外

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

関連項目:

OracleStringのメソッド

OracleStringのメソッドを表5-86に示します。

表5-86 OracleStringのメソッド
メソッド 説明

Clone

現在のOracleStringインスタンスのコピーを返します。

CompareTo

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

Equals

オブジェクトが現在のOracleString構造体と同じ文字列値を持つかどうかを判断します(オーバーロード)。

GetHashCode

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

GetNonUnicodeBytes

OracleStringの内容を含むバイト配列をクライアント・キャラクタ・セット形式で返します。

GetType

Objectから継承されます。

GetUnicodeBytes

OracleStringの内容を含むバイト配列をUnicode形式で返します。

ToString

現在のOracleStringインスタンスをstringに変換します。

関連項目:

Clone

このメソッドは、OracleStringインスタンスのコピーを作成します。

宣言
// C#
public OracleString Clone();
戻り値

OracleString構造体

備考

クローニングされたオブジェクトは、クローニング元のオブジェクトと同じプロパティ値を持ちます。

// C#
...
OracleString str_cloned = str.Clone();
...

関連項目:

CompareTo

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

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

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

実装

IComparable

例外

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

備考

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

Equals

このメソッドは、指定されたオブジェクトがOracleStringのインスタンスで、現在のOracleStringインスタンスと同じ値を持つかどうかを判断します。

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

指定されたオブジェクトがOracleStringのインスタンスで、現在のOracleStringインスタンスと同じ値を持つ場合、trueを返します。それ以外の場合、falseを返します。

備考

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

GetHashCode

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

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

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

ハッシュ・コードを表す数値

関連項目:

GetNonUnicodeBytes

このメソッドは、OracleStringの内容を含むバイト配列をクライアント・キャラクタ・セット形式で返します。

宣言
// C#
public byte[] GetNonUnicodeBytes();
戻り値

クライアント・キャラクタ・セット形式のOracleStringの内容を含むバイト配列

備考

現在のインスタンスがnull値を持つ場合、OracleNullValueExceptionがスローされます。

関連項目:

GetUnicodeBytes

このメソッドは、OracleStringの内容を含むバイト配列をUnicode形式で返します。

宣言
// C#
public byte[] GetUnicodeBytes();
戻り値

Unicode形式のOracleStringの内容を含むバイト配列

備考

現在のインスタンスがnull値を持つ場合、OracleNullValueExceptionがスローされます。

関連項目:

ToString

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

このメソッドは、現在のOracleStringインスタンスをstringに変換します。

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

string

備考

現在のOracleStringインスタンスが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
索引