| Oracle® Data Provider for .NET開発者ガイド リリース9.2.0.4 部品番号 B13807-01 |
|
Oracle.DataAccess.Typesネームスペース(ODP.NET型)、7/19
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のコンストラクタを表5-74に示します。
| コンストラクタ | 説明 |
|---|---|
|
OracleString構造体の新規インスタンスをインスタンス化します(オーバーロード)。 |
OracleStringのstaticフィールドを表5-75に示します。
| フィールド | 説明 |
|---|---|
|
|
OracleStringのstaticメソッドを表5-76に示します。
OracleStringのstatic演算子を表5-77に示します。
OracleStringの型変換を表5-78に示します。
| 演算子 | 説明 |
|---|---|
|
指定された |
|
|
指定された |
OracleStringのプロパティを表5-79に示します。
| プロパティ | 説明 |
|---|---|
|
文字列の比較を実行する際に、大/小文字を無視する必要があるかどうかを指定します。 |
|
|
現在のインスタンスがnull値を持つかどうかを示します。 |
|
|
インデックスを使用して |
|
|
|
OracleStringのメソッドを表5-80に示します。
OracleStringのコンストラクタは、OracleString構造体の新規インスタンスを作成します。
このコンストラクタは、OracleString構造体の新規インスタンスを作成し、文字列を使用してその値を設定します。
このコンストラクタは、OracleString構造体の新規インスタンスを作成し、文字列を使用してその値を設定し、比較の際に大/小文字を無視するかどうかを指定します。
このコンストラクタは、OracleString構造体の新規インスタンスを作成し、バイト配列を使用してその値を設定し、指定されたバイト配列をUnicodeエンコードするかどうかを指定します。
このコンストラクタは、OracleString構造体の新規インスタンスを作成し、バイト配列を使用してその値を設定し、指定されたバイト配列をUnicodeエンコードするかどうか、および比較の際に大/小文字を無視するかどうかを指定します。
このコンストラクタは、OracleString構造体の新規インスタンスを作成し、バイト配列を使用してその値を設定し、バイト配列の開始インデックス、バイト配列からコピーするバイト数、および指定されたバイト配列をUnicodeエンコードするかどうかを指定します。
このコンストラクタは、OracleString構造体の新規インスタンスを作成し、バイト配列を使用してその値を設定し、バイト配列の開始インデックス、バイト配列からコピーするバイト数、指定されたバイト配列をUnicodeエンコードするかどうか、および比較の際に大/小文字を無視するかどうかを指定します。
このコンストラクタは、OracleString構造体の新規インスタンスを作成し、文字列を使用してその値を設定します。
// C# public OracleString(string data);
このコンストラクタは、OracleString構造体の新規インスタンスを作成し、文字列を使用してその値を設定し、比較の際に大/小文字を無視するかどうかを指定します。
// C# public OracleString(string data, bool isCaseIgnored);
このコンストラクタは、OracleString構造体の新規インスタンスを作成し、バイト配列を使用してその値を設定し、指定されたバイト配列をUnicodeエンコードするかどうかを指定します。
// C# public OracleString(byte[] data, bool fUnicode);
data
新しいOracleStringのバイト配列データ。
fUnicode
指定されたdataをUnicodeエンコードするかどうかを指定します。Unicodeエンコードする場合、trueを指定します。それ以外の場合、falseを指定します。
ArgumentNullException: dataパラメータがnullです。
このコンストラクタは、OracleString構造体の新規インスタンスを作成し、バイト配列を使用してその値を設定し、指定されたバイト配列をUnicodeエンコードするかどうか、および比較の際に大/小文字を無視するかどうかを指定します。
// C# public OracleString(byte[] data, bool fUnicode, bool isCaseIgnored);
data
新しいOracleStringのバイト配列データ。
fUnicode
指定されたdataをUnicodeエンコードするかどうかを指定します。Unicodeエンコードする場合、trueを指定します。それ以外の場合、falseを指定します。
isCaseIgnored
比較の際に大/小文字を無視するかどうかを指定します。大/小文字を無視する場合、trueを指定します。それ以外の場合、falseを指定します。
ArgumentNullException: dataパラメータがnullです。
このコンストラクタは、OracleString構造体の新規インスタンスを作成し、バイト配列を使用してその値を設定し、バイト配列の開始インデックス、バイト配列からコピーするバイト数、および指定されたバイト配列をUnicodeエンコードするかどうかを指定します。
// C# public OracleString(byte[] data, int index, int count, bool fUnicode);
data
新しいOracleStringのバイト配列データ。
index
dataからコピーするための開始インデックス。
count
コピーするバイト数。
fUnicode
指定されたdataをUnicodeエンコードするかどうかを指定します。Unicodeエンコードする場合、trueを指定します。それ以外の場合、falseを指定します。
ArgumentNullException: dataパラメータがnullです。
ArgumentOutOfRangeException: countパラメータが0より小さいです。
IndexOutOfRangeException: indexパラメータがdataの長さ以上であるか、0より小さいです。
このコンストラクタは、OracleString構造体の新規インスタンスを作成し、バイト配列を使用してその値を設定し、バイト配列の開始インデックス、バイト配列からコピーするバイト数、指定されたバイト配列をUnicodeエンコードするかどうか、および比較の際に大/小文字を無視するかどうかを指定します。
// C# public OracleString(byte[] data, int index, int count, bool fUnicode, bool isCaseIgnored);
data
新しいOracleStringのバイト配列データ。
index
dataからコピーするための開始インデックス。
count
コピーするバイト数。
fUnicode
指定されたdataをUnicodeエンコードするかどうかを指定します。Unicodeエンコードする場合、trueを指定します。それ以外の場合、falseを指定します。
isCaseIgnored
比較の際に大/小文字を無視するかどうかを指定します。大/小文字を無視する場合、trueを指定します。それ以外の場合、falseを指定します。
ArgumentNullException: dataパラメータがnullです。
ArgumentOutOfRangeException: countパラメータが0より小さいです。
IndexOutOfRangeException: indexパラメータがdataの長さ以上であるか、0より小さいです。
OracleStringのstaticフィールドを表5-81に示します。
| フィールド | 説明 |
|---|---|
|
|
このstaticフィールドは、OracleString構造体のインスタンスに割り当てられるnull値を表します。
// C# public static readonly OracleString Null;
OracleStringのstaticメソッドを表5-82に示します。
このstaticメソッドは、2つのOracleStringインスタンスを連結し、その結果を表す新しいOracleStringインスタンスを返します。
// C# public static OracleString Concat(OracleString str1, OracleString str2);
OracleString
いずれかの引数がnull値を持つ場合、返されるOracleString構造体はnull値を持ちます。
Objectをオーバーロードします。
このstaticメソッドは、2つの比較対象のOracleStringが等しいかどうかを判断します。
// C# public static bool Equals(OracleString str1, OracleString str2);
2つの比較対象のOracleStringが等しい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
このstaticメソッドは、2つのOracleString値の1つ目の値が2つ目の値より大きいかどうかを判断します。
// C# public static bool GreaterThan(OracleString str1, OracleString str2);
2つのOracleStringの1つ目の値が2つ目の値より大きい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
このstaticメソッドは、2つのOracleString値の1つ目の値が2つ目の値以上かどうかを判断します。
// C# public static bool GreaterThanOrEqual(OracleString str1, OracleString str2);
2つのOracleStringの1つ目の値が2つ目の値以上の場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
このstaticメソッドは、2つのOracleString値の1つ目の値が2つ目の値より小さいかどうかを判断します。
// C# public static bool LessThan(OracleString str1, OracleString str2);
1つ目の値が2つ目の値より小さい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
このstaticメソッドは、2つのOracleString値の1つ目の値が2つ目の値以下かどうかを判断します。
// C# public static bool LessThanOrEqual(OracleString str1, OracleString str2);
1つ目の値が2つ目の値以下の場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
このstaticメソッドは、2つのOracleString値が等しくないかどうかを判断します。
// C# public static bool NotEquals(OracleString str1, OracleString str2);
2つのOracleStringインスタンスが等しくない場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleStringのstatic演算子を表5-83に示します。
このstatic演算子は、2つのOracleString値を連結します。
// C# public static OracleString operator + (OracleString value1, OracleString value2);
OracleString
いずれかの引数がnull値を持つ場合、返されるOracleString構造体はnull値を持ちます。
このstatic演算子は、2つのOracleString値が等しいかどうかを判断します。
// C# public static bool operator == (OracleString value1, OracleString value2);
2つのOracleString値が等しい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
このstatic演算子は、2つのOracleString値の1つ目の値が2つ目の値より大きいかどうかを判断します。
// C# public static bool operator > (OracleString value1, OracleString value2);
2つのOracleString値の1つ目の値が2つ目の値より大きい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
このstatic演算子は、2つのOracleString値の1つ目の値が2つ目の値以上かどうかを判断します。
// C# public static bool operator >= (OracleString value1, OracleString value2);
2つのOracleString値の1つ目の値が2つ目の値以上の場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
このstatic演算子は、2つのOracleString値が等しくないかどうかを判断します。
// C# public static bool operator != (OracleString value1, OracleString value2);
2つのOracleString値が等しくない場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
このstatic演算子は、2つのOracleStringの1つ目の値が2つ目の値より小さいかどうかを判断します。
// C# public static bool operator < (OracleString value1, OracleString value2);
2つのOracleStringの1つ目の値が2つ目の値より小さい場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
このstatic演算子は、2つのOracleString値の1つ目の値が2つ目の値以下かどうかを判断します。
// C# public static bool operator <= (OracleString value1, OracleString value1);
2つのOracleString値の1つ目の値が2つ目の値以下の場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
OracleStringの型変換を表5-84に示します。
| 演算子 | 説明 |
|---|---|
|
指定された |
|
|
指定された |
この型変換演算子は、指定されたOracleStringをstringに変換します。
//C# public static explicit operator string (OracleString value1);
string
OracleNullValueException: OracleString構造体がnull値を持ちます。
この型変換演算子は、指定されたstringをOracleStringに変換します。
// C# public static implicit operator OracleString (string value1);
OracleString
OracleStringのプロパティを表5-85に示します。
| プロパティ | 説明 |
|---|---|
|
文字列の比較を実行する際に、大/小文字を無視する必要があるかどうかを指定します。 |
|
|
現在のインスタンスがnull値を持つかどうかを示します。 |
|
|
インデックスを使用して |
|
|
|
このプロパティは、文字列の比較を実行する際に、大/小文字を無視する必要があるかどうかを指定します。
//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
このプロパティは、現在のインスタンスがnull値を持つかどうかを示します。
// C# public bool IsNull {get;}
現在のインスタンスがnull値を持つ場合、trueを返します。それ以外の場合、falseを返します。
このプロパティは、インデックスを使用してOracleStringの特定の文字を取得します。
// C# public char Item {get;}
char値
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
このプロパティは、OracleStringの長さを返します。
// C# public int Length {get;}
int値
OracleNullValueException: 現在のインスタンスがnull値を持ちます。
OracleStringのメソッドを表5-86に示します。
このメソッドは、OracleStringインスタンスのコピーを作成します。
// C# public OracleString Clone();
OracleString構造体
クローニングされたオブジェクトは、クローニング元のオブジェクトと同じプロパティ値を持ちます。
// C# ... OracleString str_cloned = str.Clone(); ...
このメソッドは、現在のOracleStringインスタンスを指定されたオブジェクトと比較し、その相対値を表す整数を返します。
// C# public int CompareTo(object obj);
このメソッドは、次の数値を返します。
OracleString値がobjの値より小さい場合
OracleString値がobjの値と等しい場合
OracleString値がobjの値より大きい場合
IComparable
ArgumentException: objパラメータがOracleString型ではありません。
このメソッドの動作には、次の規則が適用されます。
OracleString同士で行う必要があります。たとえば、OracleStringインスタンスとOracleBinaryインスタンスを比較することはできません。OracleStringを異なる型と比較すると、ArgumentExceptionがスローされます。
OracleStringは、null値を持つOracleStringより大きいことになります。
OracleStringがnull値を持つ場合、2つは等しいことになります。
このメソッドは、指定されたオブジェクトがOracleStringのインスタンスで、現在のOracleStringインスタンスと同じ値を持つかどうかを判断します。
// C# public override bool Equals(object obj);
指定されたオブジェクトがOracleStringのインスタンスで、現在のOracleStringインスタンスと同じ値を持つ場合、trueを返します。それ以外の場合、falseを返します。
このメソッドの動作には、次の規則が適用されます。
Objectをオーバーライドします。
このメソッドは、OracleStringインスタンスのハッシュ・コードを返します。
// C# public override int GetHashCode();
ハッシュ・コードを表す数値
このメソッドは、OracleStringの内容を含むバイト配列をクライアント・キャラクタ・セット形式で返します。
// C# public byte[] GetNonUnicodeBytes();
クライアント・キャラクタ・セット形式のOracleStringの内容を含むバイト配列
現在のインスタンスがnull値を持つ場合、OracleNullValueExceptionがスローされます。
このメソッドは、OracleStringの内容を含むバイト配列をUnicode形式で返します。
// C# public byte[] GetUnicodeBytes();
Unicode形式のOracleStringの内容を含むバイト配列
現在のインスタンスがnull値を持つ場合、OracleNullValueExceptionがスローされます。
Objectをオーバーライドします。
このメソッドは、現在のOracleStringインスタンスをstringに変換します。
// C# public override string ToString();
string
現在のOracleStringインスタンスがnull値を持つ場合、返される文字列にはnullが含まれます。
|
|
![]() Copyright © 2002, 2003 Oracle Corporation. All Rights Reserved. |
|