DataReader.GetBytes, méthode (String, array<Byte[], Int32, Int32)

Article
05/16/2015

Extrait un nombre d'octets spécifié de données binaires brutes.

Espace de noms : Microsoft.VisualStudio.Data.Framework
Assembly : Microsoft.VisualStudio.Data.Framework (dans Microsoft.VisualStudio.Data.Framework.dll)

Syntaxe

'Déclaration
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

Paramètres

name
Type : String

Nom de l'élément pour lequel récupérer des données binaires brutes.

buffer
Type : array<Byte[]

Un tableau dans lequel les données spécifiées, comme un tableau d'octets, doivent être placées. Si nullune référence null (Nothing en Visual Basic), cette méthode retourne la taille requise du tableau pour ajuster toutes les données spécifiées.

bufferIndex
Type : Int32

Index du point de départ dans le tableau d'octets spécifié dans le paramètre buffer.

length
Type : Int32

Nombre d'octets à lire dans le tableau d'octets spécifié dans le paramètre buffer.

Valeur de retour

Type : Int32
Valeur entière indiquant le nombre d'octets en mémoire tampon.

Implémentations

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

Notes

Lorsque les données sont présentées par le fournisseur de DDEX sous la forme d'octets bruts, appelez cette méthode en lecture seule un nombre d'octets spécifié dans une mémoire tampon côté client existante. Cela fournit de meilleures performances que simplement extrayant la valeur entière, qui provoque toutes les données à lire et être allouées en mémoire.

Cette méthode appelle GetItemIndex pour obtenir l'index correspondant au nom d'élément et passe ensuite cet index à l'GetBytes pour récupérer le nombre d'octets demandé de données binaires brutes.

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, voir Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.