SqlCeDataReader.GetBytes メソッド

.NET Framework クラス ライブラリ リファレンス

SqlCeDataReader.GetBytes メソッド

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

名前空間: System.Data.SqlServerCe
アセンブリ: System.Data.SqlServerCe (system.data.sqlserverce.dll 内)
構文

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As SqlCeDataReader
Dim ordinal As Integer
Dim dataIndex As Long
Dim buffer As Byte()
Dim bufferIndex As Integer
Dim length As Integer
Dim returnValue As Long

returnValue = instance.GetBytes(ordinal, dataIndex, buffer, bufferIndex, length)

C#

public override long GetBytes (
    int ordinal,
    long dataIndex,
    byte[] buffer,
    int bufferIndex,
    int length
)

C++

public:
virtual long long GetBytes (
    int ordinal, 
    long long dataIndex, 
    array<unsigned char>^ buffer, 
    int bufferIndex, 
    int length
) override

J#

public long GetBytes (
    int ordinal, 
    long dataIndex, 
    byte[] buffer, 
    int bufferIndex, 
    int length
)

JScript

public override function GetBytes (
    ordinal : int, 
    dataIndex : long, 
    buffer : byte[], 
    bufferIndex : int, 
    length : int
) : long

パラメータ

ordinal

列の 0 から始まる序数。

dataIndex

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

buffer

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

bufferIndex

読み込みを開始する buffer のインデックス。

length

バッファにコピーする最大データ長。

戻り値
実際に読み込まれたバイト数。

例外

例外の種類	条件
InvalidOperationException	操作が有効ではありません。SqlCeDataReader が、結果セットの最後の行よりも後に置かれている可能性があります。

解説

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

null 参照 (Visual Basic では Nothing) のバッファを渡すと、GetBytes は、バイト単位のフィールド長を返します。

変換は実行されません。そのため、取得するデータはバイト配列である必要があります。

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows CE, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows XP Professional x64 Edition, Windows XP SP2

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
SqlCeDataReader クラス
SqlCeDataReader メンバ
System.Data.SqlServerCe 名前空間