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

定義

名前空間:

System.Data.Odbc

アセンブリ:

System.Data.Odbc.dll

パッケージ:

System.Data.Odbc v8.0.0

ソース:

OdbcDataReader.cs

特定のバッファー オフセットを開始位置として、指定した列オフセットからバッファーに、バイトのストリームを配列として読み込みます。

public:
 override long GetBytes(int i, long dataIndex, cli::array <System::Byte> ^ buffer, int bufferIndex, int length);

public override long GetBytes (int i, long dataIndex, byte[]? buffer, int bufferIndex, int length);

override this.GetBytes : int * int64 * byte[] * int * int -> int64

Public Overrides Function GetBytes (i As Integer, dataIndex As Long, buffer As Byte(), bufferIndex As Integer, length As Integer) As Long

パラメーター

i

Int32

0 から始まる列序数。

dataIndex

Int64

読み取り操作を開始するフィールド内のインデックス。

buffer

Byte[]

バイトのストリームを読み込むバッファー。

bufferIndex

Int32

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

length

Int32

読み取るバイト数。

戻り値

Int64

実際に読み取られたバイト数。

注釈

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

null 値のバッファーを渡すと、 GetBytes フィールドの長さがバイト単位で返されます。

変換は、ODBC ドライバーの基になる機能に基づいて実行されます。 変換がサポートされていない場合、メソッド呼び出しは失敗します。

注意

の値が配列の bufferIndex 外側にある場合、例外はスローされません。 データは読み取られず、メソッドは 0 を返します。

こちらもご覧ください

• DataAdapter と DataReader