OdbcDataReader.GetBytes(Int32, Int64, Byte[], Int32, Int32) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Lit un flux d’octets du décalage de colonne spécifié dans la mémoire tampon en tant que tableau, en commençant par le décalage 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
Ordinal de colonne de base zéro.
- dataIndex
- Int64
Index dans le champ où l’opération de lecture doit démarrer.
- buffer
- Byte[]
Mémoire tampon dans laquelle lire le flux d’octets.
- bufferIndex
- Int32
Index dans l’emplacement buffer où l’opération d’écriture doit démarrer.
- 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, c’est la longueur exacte du champ. Toutefois, le nombre retourné peut être inférieur à la longueur réelle du champ s’il GetBytes a déjà été utilisé pour obtenir des octets à partir du champ. Il peut s’agir, par exemple, de la OdbcDataReader lecture d’une structure de données volumineuse dans une mémoire tampon. Pour plus d’informations, consultez le SequentialAccess paramètre pour CommandBehavior.
Si vous passez 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.
Note
Aucune exception n’est levée si la valeur d’un bufferIndex tableau est en dehors du tableau. Aucune donnée n’est lue et la méthode retourne 0.