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

定義

名前空間:

System.Data.OleDb

アセンブリ:

System.Data.OleDb.dll

パッケージ:

System.Data.OleDb v8.0.0

ソース:

OleDbDataReader.cs

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

public:
 override 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);

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

パラメーター

ordinal

Int32

0 から始まる列序数。

dataIndex

Int64

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

buffer

Char[]

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

bufferIndex

Int32

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

length

Int32

読み取る文字の数。

戻り値

Int64

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

注釈

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

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

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

こちらもご覧ください

• DataAdapter と DataReader