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

Article
11/15/2012

Récupère 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 : System.String
Le nom de l'élément pour lequel récupérer des données binaires brutes.

buffer
Type : array<System.Byte[]
Un tableau dans lequel les données spécifiées, comme un tableau d'octets, doivent être définies.Si nullune référence null (Nothing en Visual Basic), cette méthode retourne la taille requise du tableau pour s'adapter à toutes les données spécifiées.

bufferIndex
Type : System.Int32
Index du point de départ dans le tableau d'octets spécifié dans le paramètre d' buffer .

length
Type : System.Int32
Le nombre d'octets à lire dans le tableau d'octets spécifié dans le paramètre d' buffer .

Valeur de retour

Type : System.Int32
Une valeur entière indiquant le nombre d'octets a lu dans la 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 pour lire uniquement un nombre d'octets spécifié dans une mémoire tampon côté client existant.Cela offre de meilleures performances que simplement extrayant la valeur entière, ce qui entraîne toutes les données soient lues et 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, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.