DataReader.GetBytes-Methode (String, array<Byte[], Int32, Int32)

Artikel
05/16/2015

Ruft eine angegebene Anzahl Bytes unformatierte Binärdaten ab.

Namespace: Microsoft.VisualStudio.Data.Framework
Assembly: Microsoft.VisualStudio.Data.Framework (in Microsoft.VisualStudio.Data.Framework.dll)

Syntax

'Declaration
Public Overridable Function GetBytes ( _
    name As String, _
    buffer As Byte(), _
    bufferIndex As Integer, _
    length As Integer _
) As Integer

public virtual int GetBytes(
    string name,
    byte[] buffer,
    int bufferIndex,
    int length
)

public:
virtual int GetBytes(
    String^ name, 
    array<unsigned char>^ buffer, 
    int bufferIndex, 
    int length
)

abstract GetBytes : 
        name:string * 
        buffer:byte[] * 
        bufferIndex:int * 
        length:int -> int  
override GetBytes : 
        name:string * 
        buffer:byte[] * 
        bufferIndex:int * 
        length:int -> int

public function GetBytes(
    name : String, 
    buffer : byte[], 
    bufferIndex : int, 
    length : int
) : int

Parameter

name
Typ: String

Der Name des Elements, sodass das die Rohdaten- Binärdaten abruft.

buffer
Typ: array<Byte[]

Ein Array, im angegebenen Daten, z Bytearray, abgelegt werden sollen. Wenn nullein Nullverweis (Nothing in Visual Basic), diese Methode der Größe zurückgibt, die aus dem Array benötigt wird, um alle angegebenen Daten angepasst.

bufferIndex
Typ: Int32

Der Index des Anfangspunkts im Bytearray im Parameter buffer angegeben.

length
Typ: Int32

Die Anzahl für das Bytearray zu lesende Bytes angegeben wurde, im buffer-Parameter.

Rückgabewert

Typ: Int32
Ein ganzzahliger Wert, der die Anzahl der gelesenen Bytes in den Puffer angibt.

Implementiert

IVsDataReader.GetBytes(String, array<Byte[], Int32, Int32)

Hinweise

Wenn Daten durch den DDEX-Anbieter in Form von unformatierten Bytes erstellt werden, rufen Sie diese Methode auf den schreibgeschützten Zugriff eine angegebene Anzahl Bytes in einen vorhandenen clientseitigen Puffer auf. Dies bietet eine bessere Leistung als den Ganzwert einfach, Abrufen, der alle Daten wird, im Arbeitsspeicher gelesen werden und verknüpft werden.

Dies führt intern GetItemIndex, um von index entsprechend dem Elementnamen abzurufen und anschließend diesen Index für GetBytes, um die angeforderte Anzahl von Bytes unformatierten Binärdaten abzurufen.

.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.