DataReader.GetBytes, méthode (Int32, 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 MustOverride Function GetBytes ( _
    index As Integer, _
    buffer As Byte(), _
    bufferIndex As Integer, _
    length As Integer _
) As Integer

public abstract int GetBytes(
    int index,
    byte[] buffer,
    int bufferIndex,
    int length
)

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

abstract GetBytes : 
        index:int * 
        buffer:byte[] * 
        bufferIndex:int * 
        length:int -> int

public abstract function GetBytes(
    index : int, 
    buffer : byte[], 
    bufferIndex : int, 
    length : int
) : int

Paramètres

index
Type : Int32

Index dans le bloc actuel de données pour l'élément récupérer.

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(Int32, array<Byte[], Int32, Int32)

Exceptions

Exception	Condition
ArgumentOutOfRangeException	index, bufferIndex, et/ou les paramètres length sont valides.

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.

Remarques à l'attention des héritiers

La classe dérivée doit substituer cette méthode.

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.