Partager via


OdbcDataReader.GetBytes(Int32, Int64, Byte[], Int32, Int32) Méthode

Définition

Lit un flux d'octets à partir de l'offset de colonne spécifié dans la mémoire tampon sous la forme d'un tableau, en commençant à l'offset de mémoire tampon spécifique.

public:
 override long GetBytes(int i, long dataIndex, cli::array <System::Byte> ^ buffer, int bufferIndex, int length);
public:
 virtual long GetBytes(int i, long dataIndex, cli::array <System::Byte> ^ buffer, int bufferIndex, int length);
public override long GetBytes (int i, long dataIndex, byte[]? buffer, int bufferIndex, int length);
public long GetBytes (int i, long dataIndex, byte[] buffer, int bufferIndex, int length);
public override long GetBytes (int i, long dataIndex, byte[] buffer, int bufferIndex, int length);
override this.GetBytes : int * int64 * byte[] * int * int -> int64
abstract member GetBytes : int * int64 * byte[] * int * int -> int64
override this.GetBytes : int * int64 * byte[] * int * int -> int64
Public Overrides Function GetBytes (i As Integer, dataIndex As Long, buffer As Byte(), bufferIndex As Integer, length As Integer) As Long
Public Function GetBytes (i As Integer, dataIndex As Long, buffer As Byte(), bufferIndex As Integer, length As Integer) As Long

Paramètres

i
Int32

Numéro de colonne de base zéro.

dataIndex
Int64

Index figurant dans le champ où doit commencer l'opération de lecture.

buffer
Byte[]

La mémoire tampon dans laquelle le flux d’octets doit être lu.

bufferIndex
Int32

Index figurant dans le buffer où doit commencer l'opération d'écriture.

length
Int32

Nombre d'octets à lire.

Retours

Nombre réel d'octets lus.

Implémente

Remarques

GetBytes retourne le nombre d’octets disponibles dans le champ. La plupart du temps, il s’agit de la longueur exacte du champ. Toutefois, le nombre retourné peut être inférieur à la longueur réelle du champ si GetBytes a déjà été utilisé pour obtenir des octets du champ. Cela peut être le cas, par exemple, si le OdbcDataReader lit une structure de données volumineuse dans une mémoire tampon. Pour plus d’informations, consultez le SequentialAccess paramètre pour CommandBehavior.

Si vous transmettez une mémoire tampon qui est une valeur null, GetBytes retourne la longueur du champ en octets.

Les conversions sont effectuées en fonction des fonctionnalités sous-jacentes du pilote ODBC. Si la conversion n’est pas prise en charge, l’appel de méthode échoue.

Notes

Aucune exception n’est levée si la valeur de bufferIndex est en dehors du tableau. Aucune donnée n’est lue et la méthode retourne 0.

S’applique à

Voir aussi