OracleDataReader.GetChars(Int32, Int64, Char[], Int32, Int32) OracleDataReader.GetChars(Int32, Int64, Char[], Int32, Int32) OracleDataReader.GetChars(Int32, Int64, Char[], Int32, Int32) OracleDataReader.GetChars(Int32, Int64, Char[], Int32, Int32) Method

定義

指定した列オフセットから、指定したバッファー オフセットから始まる文字列ストリームを、配列としてバッファーに読み取ります。Reads a stream of characters from the specified column offset into the buffer as an array, starting at the given buffer offset.

public:
 override long GetChars(int i, long fieldOffset, cli::array <char> ^ buffer2, int bufferoffset, int length);
public override long GetChars (int i, long fieldOffset, char[] buffer2, int bufferoffset, int length);
override this.GetChars : int * int64 * char[] * int * int -> int64
Public Overrides Function GetChars (i As Integer, fieldOffset As Long, buffer2 As Char(), bufferoffset As Integer, length As Integer) As Long

パラメーター

i
Int32 Int32 Int32 Int32

0 から始まる列序数。The zero-based column ordinal.

fieldOffset
Int64 Int64 Int64 Int64

読み込みを開始する行内のインデックス。The index within the row where the read operation is to begin.

buffer2
Char[]

データのコピー先のバッファー。The buffer into which to copy data.

bufferoffset
Int32 Int32 Int32 Int32

buffer2 が書き込み操作を開始するインデックス。The index where buffer2 is to begin the write operation.

length
Int32 Int32 Int32 Int32

読み取る文字の数。The number of characters to read.

戻り値

実際に読み取られた文字数。The actual number of characters read.

注釈

GetCharsフィールド内の使用可能な文字数を返します。GetChars returns the number of available characters in the field. ほとんどの場合、これはフィールドの正確な長さです。In most cases this is the exact length of the field. ただし、がフィールドから文字を取得するために既に使用されGetCharsている場合、返される数値は、フィールドの実際の長さよりも小さくなることがあります。However, the number returned may be less than the true length of the field if GetChars has already been used to obtain characters from the field. たとえば、 OracleDataReaderが大きなデータ構造体をバッファーに読み込んでいる場合などです。This may be the case, for example, if the OracleDataReader is reading a large data structure into a buffer. 詳細については、 SequentialAccess 「」 CommandBehaviorの設定を参照してください。For more information, see the SequentialAccess setting of CommandBehavior.

Null 値のバッファーを渡す場合。If you pass a buffer that is a null value. GetCharsフィールドの長さを文字数で返します。GetChars returns the length of the field in characters.

適用対象