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

定義

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

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

パラメーター

i
Int32

0 から始まる列序数。

fieldoffset
Int64

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

buffer
Char[]

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

bufferoffset
Int32

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

length
Int32

読み取るバイト数。

戻り値

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

例外

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

注釈

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

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

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

適用対象