OracleDataReader.GetBytes(Int32, Int64, Byte[], Int32, Int32) メソッド

定義

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

public:
 virtual long GetBytes(int i, long fieldOffset, cli::array <System::Byte> ^ buffer2, int bufferoffset, int length);
public:
 override long GetBytes(int i, long fieldOffset, cli::array <System::Byte> ^ buffer2, int bufferoffset, int length);
public long GetBytes (int i, long fieldOffset, byte[] buffer2, int bufferoffset, int length);
public override long GetBytes (int i, long fieldOffset, byte[] buffer2, int bufferoffset, int length);
abstract member GetBytes : int * int64 * byte[] * int * int -> int64
override this.GetBytes : int * int64 * byte[] * int * int -> int64
override this.GetBytes : int * int64 * byte[] * int * int -> int64
Public Function GetBytes (i As Integer, fieldOffset As Long, buffer2 As Byte(), bufferoffset As Integer, length As Integer) As Long
Public Overrides Function GetBytes (i As Integer, fieldOffset As Long, buffer2 As Byte(), bufferoffset As Integer, length As Integer) As Long

パラメーター

i
Int32

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

fieldOffset
Int64

読み込みを開始するフィールド内のインデックス。The index within the field where the read operation is to begin.

buffer2
Byte[]

バイトのストリームを読み込むバッファー。The buffer into which to read the stream of bytes.

bufferoffset
Int32

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

length
Int32

読み取るバイト数。The number of bytes to read.

戻り値

Int64

実際に読み取られたバイト数。The actual number of bytes read.

実装

注釈

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

Null 値のバッファーを渡した場合、は GetBytes フィールドの長さをバイト単位で返します。If you pass a buffer that is a null value, GetBytes returns the length of the field in bytes.

適用対象