Freigeben über


SqlCeResultSet.GetBytes-Methode

Kopiert eine Bytelänge in den Puffer, beginnend bei einer angegebenen Position im angegebenen Feld.

Namespace:  System.Data.SqlServerCe
Assembly:  System.Data.SqlServerCe (in System.Data.SqlServerCe.dll)

Syntax

'Declaration
Public Overrides Function GetBytes ( _
    ordinal As Integer, _
    dataIndex As Long, _
    buffer As Byte(), _
    bufferIndex As Integer, _
    length As Integer _
) As Long
'Usage
Dim instance As SqlCeResultSet
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)
public override long GetBytes(
    int ordinal,
    long dataIndex,
    byte[] buffer,
    int bufferIndex,
    int length
)
public:
virtual long long GetBytes(
    int ordinal, 
    long long dataIndex, 
    array<unsigned char>^ buffer, 
    int bufferIndex, 
    int length
) override
abstract GetBytes : 
        ordinal:int * 
        dataIndex:int64 * 
        buffer:byte[] * 
        bufferIndex:int * 
        length:int -> int64 
override GetBytes : 
        ordinal:int * 
        dataIndex:int64 * 
        buffer:byte[] * 
        bufferIndex:int * 
        length:int -> int64 
public override function GetBytes(
    ordinal : int, 
    dataIndex : long, 
    buffer : byte[], 
    bufferIndex : int, 
    length : int
) : long

Parameter

  • ordinal
    Typ: System.Int32
    Die Ordinalposition der Spalte, aus der Daten abgerufen werden sollen.
  • dataIndex
    Typ: System.Int64
    Der Offset (in Bytes) in dem Feld, in dem das Kopieren von Daten beginnen soll.
  • buffer
    Typ: array<System.Byte[]
    Der Puffer, in den die Daten kopiert werden sollen.
  • bufferIndex
    Typ: System.Int32
    Der Offset im Puffer, in dem mit dem Kopiervorgang begonnen werden soll.
  • length
    Typ: System.Int32
    Die maximale Anzahl der zu kopierenden Bytes.

Rückgabewert

Typ: System.Int64
Die tatsächliche Anzahl der in den Puffer kopierten Bytes.

Implementiert

IDataRecord.GetBytes(Int32, Int64, array<Byte[], Int32, Int32)

Hinweise

Diese Funktion gibt die tatsächliche Anzahl kopierter Bytes zurück. Diese Anzahl kann geringer sein als die angeforderte Länge, wenn das Ende des Felds erreicht ist.

Wenn ein Puffer übergeben wird, der NULL ist, gibt GetBytes die Länge des Felds in Bytes zurück.

Wenn der Befehl mit dem Befehlsverhalten SequentialAccess ausgeführt wird, müssen Aufrufe von GetBytes sequenziell steigende Lesevorgänge angeben, andernfalls wird eine Ausnahme ausgelöst.

GetBytes kann nur für Spalten aufgerufen werden, denen ein binary- oder ein varbinary-Typ zugrunde liegt oder die mit Objekten erstellt wurden, die in ein Bytearray umgewandelt werden können.

Es wird eine Ausnahme ausgelöst, wenn an der angegebenen Ordinalposition kein Feld vorhanden ist.

Siehe auch

Verweis

SqlCeResultSet Klasse

System.Data.SqlServerCe-Namespace