OdbcDataReader.GetBytes(Int32, Int64, Byte[], Int32, Int32) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
特定のバッファー オフセットを開始位置として、指定した列オフセットからバッファーに、バイトのストリームを配列として読み込みます。
public:
override long GetBytes(int i, long dataIndex, cli::array <System::Byte> ^ buffer, int bufferIndex, int length);
public:
virtual 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);
public long GetBytes (int i, long dataIndex, 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
abstract member GetBytes : int * int64 * byte[] * int * int -> int64
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
Public 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
読み取るバイト数。
戻り値
実際に読み取られたバイト数。
実装
注釈
GetBytes は、フィールドで使用可能なバイト数を返します。 ほとんどの場合、これはフィールドの正確な長さです。 ただし、フィールドからバイトを取得するために既に使用されている場合は、返される数値がフィールドの実際の長さよりも小さい場合 GetBytes があります。 たとえば、 が大きなデータ構造を OdbcDataReader バッファーに読み取る場合などです。 詳細については、 の設定CommandBehaviorをSequentialAccess
参照してください。
null 値のバッファーを渡すと、 GetBytes フィールドの長さがバイト単位で返されます。
変換は、ODBC ドライバーの基になる機能に基づいて実行されます。 変換がサポートされていない場合、メソッド呼び出しは失敗します。
注意
の値が配列の bufferIndex
外側にある場合、例外はスローされません。 データは読み取られず、メソッドは 0 を返します。
適用対象
こちらもご覧ください
.NET