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

定義

重要

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

指定した列オフセットから、指定したバッファーオフセットから始まる文字列ストリームを、配列としてバッファーに読み取ります。

public:
 long GetChars(int i, long fieldoffset, cli::array <char> ^ buffer, int bufferoffset, int length);

public long GetChars (int i, long fieldoffset, char[] buffer, int bufferoffset, int length);

public long GetChars (int i, long fieldoffset, char[]? buffer, int bufferoffset, int length);

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

Public Function GetChars (i As Integer, fieldoffset As Long, buffer As Char(), bufferoffset As Integer, length As Integer) As Long

0 から始まる列序数。

読み取り操作を開始する位置を示す行内のインデックス。

バイトのストリームを読み込むバッファー。

読み取り操作を開始する buffer のインデックス。

読み取るバイト数。

Int64

実際に読み取られた文字数。

渡されたインデックスは 0 から FieldCount の範囲外にあります。

GetChars は、フィールドで使用可能な文字数を返します。多くの場合、これはフィールドの正確な長さです。ただし、フィールドから文字を取得するために既に使用されている場合は、返される数値がフィールドの正確な長さよりも小さい場合 GetChars があります。

であるnullGetCharsバッファーを渡すと、フィールドの長さが文字で返されます。

変換は行われないため、取得するデータは既に文字列配列になっている必要があります。