SqlDataRecord.GetChars(Int32, Int64, Char[], Int32, Int32) メソッド

定義

名前空間:

Microsoft.Data.SqlClient.Server

アセンブリ:

Microsoft.Data.SqlClient.dll

パッケージ:

Microsoft.Data.SqlClient v5.2.0

序数で指定された列の値を Char オブジェクトの配列として取得します。

public:
 virtual long GetChars(int ordinal, long fieldOffset, cli::array <char> ^ buffer, int bufferOffset, int length);

public virtual long GetChars (int ordinal, long fieldOffset, char[] buffer, int bufferOffset, int length);

abstract member GetChars : int * int64 * char[] * int * int -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64

Public Overridable Function GetChars (ordinal As Integer, fieldOffset As Long, buffer As Char(), bufferOffset As Integer, length As Integer) As Long

パラメーター

ordinal

Int32

列の 0 から始まる序数。

fieldOffset

Int64

フィールド値内の文字の取得開始位置となるオフセット。

buffer

Char[]

文字のコピー先のバッファー。

bufferOffset

Int32

バッファー内の文字のコピー開始位置を示すオフセット。

length

Int32

バッファーにコピーする文字数。

戻り値

Int64

コピーされた文字数。

実装

GetChars(Int32, Int64, Char[], Int32, Int32)

例外

IndexOutOfRangeException

ordinal が 0 未満か、列の数を超えています (つまり、FieldCount)。

SqlNullValueException

ordinal で指定された列が NULL です。

InvalidCastException

型が一致しません。

注釈

このメソッドを使用すると、1 回の呼び出しまたはチャンクで文字値を取得できます。 値をチャンク単位で取得すると、大きな値や不明なサイズの値に役立ちます。

値を複数のチャンクで取得するには、チャンク サイズの char 配列を割り当てて、 を呼び出し、各呼び出 GetChars しでパラメーターを fieldOffset 繰り返し調整します。