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

定義

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

public:
 override long GetChars(int ordinal, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);
public:
 virtual long GetChars(int ordinal, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);
public override long GetChars (int ordinal, long dataIndex, char[]? buffer, int bufferIndex, int length);
public long GetChars (int ordinal, long dataIndex, char[] buffer, int bufferIndex, int length);
public override long GetChars (int ordinal, long dataIndex, char[] buffer, int bufferIndex, int length);
override this.GetChars : int * int64 * char[] * int * int -> int64
abstract member GetChars : int * int64 * char[] * int * int -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64
Public Overrides Function GetChars (ordinal As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long
Public Function GetChars (ordinal As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long

パラメーター

ordinal
Int32

0 から始まる列序数。

dataIndex
Int64

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

buffer
Char[]

データのコピー先のバッファー。

bufferIndex
Int32

書き込み操作を開始する buffer 内のインデックス。

length
Int32

読み取る文字の数。

戻り値

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

実装

注釈

GetChars は、フィールドで使用できる文字数を返します。 ほとんどの場合、これはフィールドの正確な長さです。 ただし、既に GetChars を使用してフィールドから文字を取得している場合、返される文字数はフィールドの正しい長さよりも少なくなる場合があります。 これは、たとえば、 が大きなデータ構造を OleDbDataReader バッファーに読み取る場合です。 詳細については、 の設定CommandBehaviorSequentialAccess参照してください。

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

変換は実行されません。したがって、取得されるデータは既に文字配列である必要があります。

適用対象

こちらもご覧ください