Partager via


Méthode SqlCeResultSet.GetBytes

Copie une longueur d'octets dans la mémoire tampon, en démarrant à une position spécifiée dans le champ indiqué.

Espace de noms :  System.Data.SqlServerCe
Assembly :  System.Data.SqlServerCe (en System.Data.SqlServerCe.dll)

Syntaxe

'Déclaration
Public Overrides Function GetBytes ( _
    ordinal As Integer, _
    dataIndex As Long, _
    buffer As Byte(), _
    bufferIndex As Integer, _
    length As Integer _
) As Long
'Utilisation
Dim instance As SqlCeResultSet
Dim ordinal As Integer
Dim dataIndex As Long
Dim buffer As Byte()
Dim bufferIndex As Integer
Dim length As Integer
Dim returnValue As Long

returnValue = instance.GetBytes(ordinal, _
    dataIndex, buffer, bufferIndex, length)
public override long GetBytes(
    int ordinal,
    long dataIndex,
    byte[] buffer,
    int bufferIndex,
    int length
)
public:
virtual long long GetBytes(
    int ordinal, 
    long long dataIndex, 
    array<unsigned char>^ buffer, 
    int bufferIndex, 
    int length
) override
abstract GetBytes : 
        ordinal:int * 
        dataIndex:int64 * 
        buffer:byte[] * 
        bufferIndex:int * 
        length:int -> int64 
override GetBytes : 
        ordinal:int * 
        dataIndex:int64 * 
        buffer:byte[] * 
        bufferIndex:int * 
        length:int -> int64 
public override function GetBytes(
    ordinal : int, 
    dataIndex : long, 
    buffer : byte[], 
    bufferIndex : int, 
    length : int
) : long

Paramètres

  • ordinal
    Type : System.Int32
    Position ordinale de la colonne à partir de laquelle récupérer les données.
  • dataIndex
    Type : System.Int64
    Offset (en octets) du champ à partir duquel commencer la copie des données.
  • buffer
    Type : array<System.Byte[]
    Mémoire tampon dans laquelle copier les données.
  • bufferIndex
    Type : System.Int32
    Offset de la mémoire tampon à partir duquel démarrer la copie.
  • length
    Type : System.Int32
    Nombre maximal d'octets à copier.

Valeur de retour

Type : System.Int64
Nombre réel d'octets copiés dans la mémoire tampon.

Implémente

IDataRecord.GetBytes(Int32, Int64, array<Byte[], Int32, Int32)

Notes

Cette fonction retourne le nombre réel d'octets copiés, qui peut être inférieur à la longueur demandée si la fin du champ est atteinte.

Si vous passez une mémoire tampon null, GetBytes retourne la longueur du champ, en octets.

Si la commande est exécutée avec un comportement SequentialAccess, les appels à GetBytes doivent spécifier des lectures à croissance séquentielle ; sinon, une exception est levée.

GetBytes ne peut être appelé que pour des colonnes dont le type sous-jacent est binary ou varbinary, ou qui ont été construites avec des objets qui peuvent faire castés en tableau d'octets.

Une exception est levée si aucun champ n'existe à la position ordinale spécifiée.

Voir aussi

Référence

SqlCeResultSet Classe

Espace de noms System.Data.SqlServerCe