次の方法で共有


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

定義

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

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

戻り値

コピーされた文字数。

実装

例外

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

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

型が一致しません。

注釈

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

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

適用対象