SqlCeDataReader.GetBytes-Methode
Liest beginnend am angegebenen Pufferoffset einen Datenstrom von Bytes aus dem angegebenen Spaltenoffset als Array in den Puffer.
Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in System.Data.SqlServerCe.dll)
Syntax
'Declaration
<SecurityTreatAsSafeAttribute> _
<SecurityCriticalAttribute> _
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 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)
[SecurityTreatAsSafeAttribute]
[SecurityCriticalAttribute]
public override long GetBytes(
int ordinal,
long dataIndex,
byte[] buffer,
int bufferIndex,
int length
)
[SecurityTreatAsSafeAttribute]
[SecurityCriticalAttribute]
public:
virtual long long GetBytes(
int ordinal,
long long dataIndex,
array<unsigned char>^ buffer,
int bufferIndex,
int length
) override
[<SecurityTreatAsSafeAttribute>]
[<SecurityCriticalAttribute>]
abstract GetBytes :
ordinal:int *
dataIndex:int64 *
buffer:byte[] *
bufferIndex:int *
length:int -> int64
[<SecurityTreatAsSafeAttribute>]
[<SecurityCriticalAttribute>]
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 nullbasierte Ordnungszahl der Spalte.
- dataIndex
Typ: System.Int64
Der Index im Feld, an dem der Lesevorgang beginnen soll.
- buffer
Typ: array<System.Byte[]
Der Puffer, in den der Bytedatenstrom gelesen werden soll.
- bufferIndex
Typ: System.Int32
Der Index für buffer, an dem der Lesevorgang beginnen soll.
- length
Typ: System.Int32
Die maximal in den Puffer zu kopierende Länge.
Rückgabewert
Typ: System.Int64
Die tatsächlich gelesene Anzahl von Bytes.
Implementiert
IDataRecord.GetBytes(Int32, Int64, array<Byte[], Int32, Int32)
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| InvalidOperationException | Der Vorgang ist ungültig. Die SqlCeDataReader-Klasse ist möglicherweise hinter der letzten Zeile im Resultset positioniert. |
Hinweise
Die GetBytes-Methode gibt die Anzahl der verfügbaren Bytes im Feld zurück. In den meisten Fällen ist dies die genaue Länge des Felds. Die zurückgegebene Anzahl kann jedoch kleiner als die tatsächliche Länge des Felds sein, wenn GetBytes bereits zum Abrufen von Bytes aus dem Feld verwendet wurde. Dies kann z. B. der Fall sein, wenn der SqlCeDataReader eine umfangreiche Datenstruktur in einen Puffer liest. Weitere Informationen finden Sie unter der SequentialAccess-Einstellung für CommandBehavior.
Wenn Sie einen Puffer übergeben, der nullein NULL-Verweis (Nothing in Visual Basic) ist, gibt die GetBytes-Methode die Länge des Felds in Bytes zurück.
Es werden keine Konvertierungen durchgeführt, daher müssen die abgerufenen Daten bereits als Bytearray vorliegen.