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

定義

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

序数で指定された列の値を 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

列の 0 から始まる序数。

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

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

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

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

Int64

コピーされた文字数。

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

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

型が一致しません。

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

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