SqlCeDataReader.GetBytes-Methode

Hinweis: Dieser Namespace oder Member bzw. diese Klasse wird nur von .NET Framework, Version 1.1, unterstützt.

Liest beginnend am angegebenen Pufferoffset einen Stream von Bytes aus dem angegebenen Spaltenoffset als Array in den Puffer.

Public Overridable Function GetBytes( _
   ByVal ordinal As Integer, _   ByVal dataIndex As Long, _   ByVal buffer() As Byte, _   ByVal bufferIndex As Integer, _   ByVal length As Integer _) As Long Implements IDataRecord.GetBytes
[C#]
public virtual long GetBytes(intordinal,longdataIndex,byte[] buffer,intbufferIndex,intlength);
[C++]
public: virtual __int64 GetBytes(intordinal,__int64dataIndex,unsigned charbuffer __gc[],intbufferIndex,intlength);
[JScript]
public function GetBytes(
   ordinal : int,dataIndex : long,buffer : Byte[],bufferIndex : int,length : int) : long;

Parameter

• ordinal
  Die nullbasierte Ordnungszahl der Spalte.
• dataIndex
  Der Index im Feld, an dem der Lesevorgang beginnen soll.
• buffer
  Der Puffer, in den der Bytestream gelesen werden soll.
• bufferIndex
  Der Index für buffer, an dem der Lesevorgang beginnen soll.
• length
  Die maximal in den Puffer zu kopierende Länge.

Rückgabewert

Die tatsächlich gelesene Anzahl von Bytes.

Implementiert

IDataRecord.GetBytes

Ausnahmen

Hinweise

GetBytes gibt die Anzahl der verfügbaren Bytes im Feld zurück. In den meisten Fällen ist dies die genaue Länge des Feldes. Die zurückgegebene Anzahl kann jedoch kleiner als die tatsächliche Länge des Feldes 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 NULL ist, gibt GetBytes die Länge des Feldes in Byte zurück.

Es werden keine Konvertierungen durchgeführt, daher müssen die abgerufenen Daten bereits als Bytearray vorliegen.

Anforderungen

Plattformen: .NET Compact Framework - Windows CE .NET

.NET Framework-Sicherheit:

• Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

SqlCeDataReader-Klasse | SqlCeDataReader-Member | System.Data.SqlServerCe-Namespace