OracleString構造

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

クラスの継承

System.Object

System.ValueType

Oracle.DataAccess.Types.OracleString

宣言

// ADO.NET 2.0: C#
public struct OracleString : IComparable, INullable, IXmlSerializable

// ADO.NET 1.x: C#
public struct OracleString : IComparable, INullable

スレッド安全性

パブリック静的メソッドはスレッドセーフですが、インスタンス・メソッドではスレッド安全性は保証されません。

例

// C#

using System;
using Oracle.DataAccess.Types;

class OracleStringSample
{
  static void Main()
  {
    // Initialize OracleString structs
    OracleString string1 = new OracleString("AAA");

    // Display the string "AAA"
    Console.WriteLine("{0} has length of {1}", string1, string1.Length);

    // Contatenate characters to string1 until the length is 5
    while (string1.Length < 5)
      string1 = OracleString.Concat(string1,"a");

    // Display the string of "AAAaa"
    Console.WriteLine("{0} has length of {1}", string1, string1.Length);
  }
}

要件

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

アセンブリ: Oracle.DataAccess.dll

Microsoft .NET Frameworkバージョン: 1.xまたは2.0

参照:

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

OracleStringメンバー

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

OracleStringコンストラクタ

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

表12-74 OracleStringコンストラクタ

コンストラクタ	説明
OracleStringコンストラクタ	`OracleString`構造の新しいインスタンスをインスタンス化します（オーバーロード）

OracleString静的フィールド

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

表12-75 OracleString静的フィールド

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

OracleString静的メソッド

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

表12-76 OracleString静的メソッド

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

OracleString静的演算子

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

表12-77 OracleString静的演算子

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

OracleString型変換

OracleString型変換のリストを、表12-78に示します。

表12-78 OracleString型変換

演算子	説明
explicit operator string	指定された`OracleString`を`string`インスタンスに変換します
implicit operator OracleString	指定された`string`を`OracleString`インスタンスに変換します

OracleStringプロパティ

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

表12-79 OracleStringプロパティ

プロパティ	説明
IsCaseIgnored	文字列比較を実行するときに、大/小文字の区別を無視する必要があるかどうかを示します
IsNull	現行インスタンスにNULL値があるかどうかを示します
Item	索引を使用して、`OracleString`内の特定の文字を取得します
Length	`OracleString`の長さを戻します

OracleStringメソッド

OracleStringメソッドのリストを、表12-80に示します。

表12-80 OracleStringメソッド

メソッド	説明
Clone	現行の`OracleString`インスタンスのコピーを戻します
CompareTo	現行の`OracleString`インスタンスを指定オブジェクトと比較し、相対値を表す整数を戻します
Equals	オブジェクトが現行の`OracleString`構造（オーバーロード）と同じ値を持っているかどうかを判別します
GetHashCode	`OracleString`インスタンスのハッシュ・コードを戻します
GetNonUnicodeBytes	クライアント・キャラクタ・セットの形式で、`OracleString`の内容を含むバイトの配列を戻します
GetType	`System.Object`からの継承
GetUnicodeBytes	Unicode形式で、`OracleString`の内容を含むバイトの配列を戻します
ToString	現行の`OracleString`インスタンスを`string`に変換します

参照:

OracleStringコンストラクタ

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

オーバーロード・リスト:

OracleString(string)

このコンストラクタは、OracleString構造の新しいインスタンスを作成し、文字列を使用して値を設定します。
OracleString(string, bool)

このコンストラクタは、OracleString構造の新しいインスタンスを作成し、文字列を使用して値を設定し、比較のときに大/小文字の区別が無視されるかどうかを指定します。
OracleString(byte [ ], bool)

このコンストラクタは、OracleString構造の新しいインスタンスを作成し、バイト配列を使用して値を設定し、指定されたバイト配列がUnicodeでエンコードされているかどうかを指定します。
OracleString(byte [ ], bool, bool)

このコンストラクタは、OracleString構造の新しいインスタンスを作成し、バイト配列を使用してその値を設定し、指定されたバイト配列がUnicodeでエンコードされているかどうかと比較のときに大/小文字の区別が無視されるかどうかを指定します。
OracleString(byte [ ], int, int, bool)

このコンストラクタは、OracleString構造の新しいインスタンスを作成し、バイト配列を使用してその値を設定し、バイト配列の開始索引とバイト配列からコピーされるバイト数、および指定されたバイト配列がUnicodeでエンコードされているかどうかを指定します。
OracleString(byte [ ], int, int, bool, bool)

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

参照:

OracleString(string)

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

宣言

// C#
public OracleString(string data);

パラメータ

data

文字列値

参照:

OracleString(string, bool)

このコンストラクタは、OracleString構造の新しいインスタンスを作成し、文字列を使用して値を設定し、比較のときに大/小文字の区別が無視されるかどうかを指定します。

宣言

// C#
public OracleString(string data, bool isCaseIgnored);

パラメータ

data

文字列値
isCaseIgnored

比較のときに大/小文字の区別が無視されるかどうかを指定します。大/小文字の区別が無視される場合はtrue、それ以外の場合はfalseを指定します。

参照:

OracleString(byte [ ], bool)

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

宣言

// C#
public OracleString(byte[] data, bool fUnicode);

パラメータ

data

新しいOracleStringのバイト配列データ
fUnicode

指定されたdataがUnicodeでエンコードされているかどうかを指定します。Unicodeでエンコードされている場合はtrue、それ以外の場合はfalseを指定します。

例外

ArgumentNullException - dataパラメータがNULLです。

参照:

OracleString(byte [ ], bool, bool)

このコンストラクタは、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(byte [ ], int, int, bool)

このコンストラクタは、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パラメータがゼロ未満です。

IndexOutOfRangeException - indexパラメータがdataの長さ以上か、ゼロ未満です。

参照:

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

このコンストラクタは、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パラメータがゼロ未満です。

IndexOutOfRangeException - indexパラメータがdataの長さ以上か、ゼロ未満です。

参照:

OracleString静的フィールド

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

表12-81 OracleString静的フィールド

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

参照:

Null

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

宣言

// C#
public static readonly OracleString Null;

参照:

OracleString静的メソッド

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

表12-82 OracleString静的メソッド

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

参照:

Concat

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

宣言

// C#
public static OracleString Concat(OracleString str1, OracleString str2);

パラメータ

str1

最初のOracleString
str2

2番目のOracleString

戻り値

OracleString

備考

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

参照:

Equals

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

この静的メソッドは、比較される2つのOracleStringが等しいかどうかを決定します。

宣言

// C#
public static bool Equals(OracleString str1, OracleString str2);

パラメータ

str1

最初のOracleString
str2

2番目のOracleString

戻り値

比較される2つのOracleStringが等しい場合はtrue、それ以外の場合はfalseを戻します。

備考

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

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

参照:

GreaterThan

この静的メソッドは、2つのOracleStringの最初の値が、2番目の値より大きいかどうかを決定します。

宣言

// C#
public static bool GreaterThan(OracleString str1, OracleString str2);

パラメータ

str1

最初のOracleString
str2

2番目のOracleString

戻り値

2つのOracleStringの最初の値が2番目の値より大きい場合はtrue、それ以外の場合はfalseを戻します。

備考

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

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

参照:

GreaterThanOrEqual

この静的メソッドでは、2つのOracleString値の最初の値が、2番目の値以上であるかどうかを決定します。

宣言

// C#
public static bool GreaterThanOrEqual(OracleString str1,
    OracleString str2);

パラメータ

str1

最初のOracleString
str2

2番目のOracleString

戻り値

2つのOracleStringの最初の値が2番目の値以上の場合はtrue、それ以外の場合はfalseを戻します。

備考

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

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

参照:

LessThan

この静的メソッドでは、2つのOracleString値の最初の値が、2番目の値より小さいかどうかを決定します。

宣言

// C#
public static bool LessThan(OracleString str1, OracleString str2);

パラメータ

str1

最初のOracleString
str2

2番目のOracleString

戻り値

最初の値が2番目の値より小さい場合はtrue、それ以外の場合はfalseを戻します。

備考

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

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

参照:

LessThanOrEqual

この静的メソッドでは、2つのOracleString値の最初の値が、2番目の値以下かどうかを決定します。

宣言

// C#
public static bool LessThanOrEqual(OracleString str1, OracleString str2);

パラメータ

str1

最初のOracleString
str2

2番目のOracleString

戻り値

最初の値が2番目の値以下の場合はtrue、それ以外の場合はfalseを戻します。

備考

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

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

参照:

NotEquals

この静的メソッドは、2つのOracleString値が等しくないかどうかを決定します。

宣言

// C#
public static bool NotEquals(OracleString str1, OracleString str2);

パラメータ

str1

最初のOracleString
str2

2番目のOracleString

戻り値

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

備考

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

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

参照:

OracleString静的演算子

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

表12-83 OracleString静的演算子

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

参照:

operator +

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

宣言

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

パラメータ

value1

最初のOracleString
value2

2番目のOracleString

戻り値

OracleString

備考

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

参照:

operator ==

この静的演算子は、2つのOracleString値が等しいかどうかを決定します。

宣言

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

パラメータ

value1

最初のOracleString
value2

2番目のOracleString

戻り値

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

備考

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

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

参照:

operator >

この静的演算子は、2つのOracleStringの最初の値が、2番目の値より大きいかどうかを決定します。

宣言

// C#
public static bool operator > (OracleString value1, OracleString value2);

パラメータ

value1

最初のOracleString
value2

2番目のOracleString

戻り値

2つのOracleStringの最初の値が2番目の値より大きい場合はtrue、それ以外の場合はfalseを戻します。

備考

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

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

参照:

operator >=

この静的演算子は、2つのOracleStringの最初の値が、2番目の値以上かどうかを決定します。

宣言

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

パラメータ

value1

最初のOracleString
value2

2番目のOracleString

戻り値

2つのOracleStringの最初の値が2番目の値以上の場合はtrue、それ以外の場合はfalseを戻します。

備考

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

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

参照:

operator !=

この静的演算子は、2つのOracleString値が等しくないかどうかを決定します。

宣言

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

パラメータ

value1

最初のOracleString
value2

2番目のOracleString

戻り値

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

備考

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

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

参照:

operator <

この静的演算子は、2つのOracleStringの最初の値が、2番目の値より小さいかどうかを決定します。

宣言

// C#
public static bool operator < (OracleString value1, OracleString value2);

パラメータ

value1

最初のOracleString
value2

2番目のOracleString

戻り値

2つのOracleStringの最初の値が2番目の値より小さい場合はtrue、それ以外の場合はfalseを戻します。

備考

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

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

参照:

operator <=

この静的演算子は、2つのOracleStringの最初の値が、2番目の値以下かどうかを決定します。

宣言

// C#
public static bool operator <= (OracleString value1, OracleString value1);

パラメータ

value1

最初のOracleString
value2

2番目のOracleString

戻り値

2つのOracleStringの最初の値が2番目の値以下の場合はtrue、それ以外の場合はfalseを戻します。

備考

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

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

参照:

OracleString型変換

OracleString型変換のリストを、表12-84に示します。

表12-84 OracleString型変換

演算子	説明
explicit operator string	指定された`OracleString`を`string`インスタンスに変換します
implicit operator OracleString	指定された`string`を`OracleString`インスタンスに変換します

参照:

explicit operator string

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

宣言

//C#
public static explicit operator string (OracleString value1);

パラメータ

value1

指定されたOracleString

戻り値

string

例外

OracleNullValueException - OracleString構造にNULL値があります。

参照:

implicit operator OracleString

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

宣言

// C#
public static implicit operator OracleString (string value1);

パラメータ

value1

指定された文字列

戻り値

OracleString

参照:

OracleStringプロパティ

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

表12-85 OracleStringプロパティ

プロパティ	説明
IsCaseIgnored	文字列比較を実行するときに、大/小文字の区別を無視する必要があるかどうかを示します
IsNull	現行インスタンスにNULL値があるかどうかを示します
Item	索引を使用して、`OracleString`内の特定の文字を取得します
Length	`OracleString`の長さを戻します

参照:

IsCaseIgnored

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

宣言

//C#
public bool IsCaseIgnored {get;set;}

プロパティ値

文字列比較で大/小文字の区別を無視する必要がある場合はtrue、それ以外の場合はfalseを戻します。

備考

デフォルト値はtrue

例

// C#

using System;
using Oracle.DataAccess.Types;

class IsCaseIgnoredSample
{
  static void Main()
  {
    OracleString string1 = new OracleString("aAaAa");
    OracleString string2 = new OracleString("AaAaA");

    // Ignore case for comparisons
    string1.IsCaseIgnored = true;
    string2.IsCaseIgnored = true;

    // Same; Prints 0
    Console.WriteLine(string1.CompareTo(string2));

    // Make comparisons case sensitive
    // Note that IsCaseIgnored must be set to false for both
    //   OracleStrings; otherwise an exception is thrown
    string1.IsCaseIgnored = false;
    string2.IsCaseIgnored = false;

    // Different; Prints nonzero value
    Console.WriteLine(string1.CompareTo(string2));
  }
}

参照:

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

プロパティ値

整数

例外

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

参照:

OracleStringメソッド

OracleStringメソッドのリストを、表12-86に示します。

表12-86 OracleStringメソッド

メソッド	説明
Clone	現行の`OracleString`インスタンスのコピーを戻します
CompareTo	現行の`OracleString`インスタンスを指定オブジェクトと比較し、相対値を表す整数を戻します
Equals	オブジェクトが現行の`OracleString`構造（オーバーロード）と同じ値を持っているかどうかを判別します
GetHashCode	`OracleString`インスタンスのハッシュ・コードを戻します
GetNonUnicodeBytes	クライアント・キャラクタ・セットの形式で、`OracleString`の内容を含むバイトの配列を戻します
GetType	`System.Object`からの継承
GetUnicodeBytes	Unicode形式で、`OracleString`の内容を含むバイトの配列を戻します
ToString	現行の`OracleString`インスタンスを`string`に変換します

参照:

Clone

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

宣言

// C#
public OracleString Clone();

戻り値

OracleString構造

備考

複製されたオブジェクトのプロパティ値は、複製元のオブジェクトのプロパティ値と同じです。

例

// C#

using System;
using Oracle.DataAccess.Types;

class CloneSample
{
  static void Main()
  {
    OracleString str1 = new OracleString("aAaAa");
    OracleString str2 = str1.Clone();

    // The OracleStrings are same; Prints 0
    Console.WriteLine(str1.CompareTo(str2));
  }
}

参照:

CompareTo

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

宣言

// C#
public int CompareTo(object obj);

パラメータ

obj

現行インスタンスと比較されるオブジェクト

戻り値

メソッドが戻す数値は次のとおりです。

ゼロ未満: 現行のOracleString値がobjより小さい場合
ゼロ: 現行のOracleString値がobjと等しい場合
ゼロ超過: 現行のOracleString値がobjより大きい場合

実装

IComparable

例外

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

備考

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

比較はOracleString間で行う必要があります。たとえば、OracleStringインスタンスとOracleBinaryインスタンスを比較することはできません。OracleStringを別の型と比較すると、ArgumentExceptionが表示されます。
値を持つすべてのOracleStringは、NULL値を持つOracleStringより大きくなります。
NULL値を含む2つのOracleStringは等しくなります。

参照:

Equals

このメソッドは、指定されたオブジェクトがOracleStringのインスタンスかどうか、および現行のOracleStringインスタンスと同じ値を持っているかどうかを決定します。

宣言

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

パラメータ

obj

比較されるオブジェクト

戻り値

指定されたオブジェクトがOracleStringのインスタンスで、現行のOracleStringインスタンスと同じ値を持っている場合はtrue、それ以外の場合はfalseを戻します。

備考

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

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

参照:

GetHashCode

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

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

宣言

// C#
public override int GetHashCode();

戻り値

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

参照:

GetNonUnicodeBytes

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

宣言

// C#
public byte[] GetNonUnicodeBytes();

戻り値

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

備考

現行インスタンスにNULL値がある場合は、OracleNullValueExceptionが表示されます。

参照:

GetUnicodeBytes

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

宣言

// C#
public byte[] GetUnicodeBytes();

戻り値

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

備考

現行インスタンスにNULL値がある場合は、OracleNullValueExceptionが表示されます。

参照:

ToString

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

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

宣言

// C#
public override string ToString();

戻り値

string

備考

現行のOracleStringインスタンスにNULL値がある場合、文字列にはNULLが含まれます。

参照: