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

定義

名前空間:

System.Data

アセンブリ:

System.Data.Common.dll

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

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);

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

読み取るバイト数。

戻り値

Int64

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

例外

IndexOutOfRangeException

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

注釈

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

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

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