OleDbDataReader.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 à partir de l'offset de colonne spécifié dans la mémoire tampon sous la forme d'un tableau commençant à l'offset de mémoire tampon donné.
public:
override long GetBytes(int ordinal, long dataIndex, cli::array <System::Byte> ^ buffer, int bufferIndex, int length);
public:
virtual long GetBytes(int ordinal, long dataIndex, cli::array <System::Byte> ^ buffer, int bufferIndex, int length);
public override long GetBytes (int ordinal, long dataIndex, byte[]? buffer, int bufferIndex, int length);
public long GetBytes (int ordinal, long dataIndex, byte[] buffer, int bufferIndex, int length);
public override long GetBytes (int ordinal, 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 (ordinal As Integer, dataIndex As Long, buffer As Byte(), bufferIndex As Integer, length As Integer) As Long
Public Function GetBytes (ordinal As Integer, dataIndex As Long, buffer As Byte(), bufferIndex As Integer, length As Integer) As Long
Paramètres
- ordinal
- Int32
Numéro de colonne de base zéro.
- dataIndex
- Int64
L’index figurant dans le champ à partir duquel l’opération de lecture doit être lancée.
- 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
Longueur maximale à copier dans la mémoire tampon.
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, lorsque le OleDbDataReader 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 passez une mémoire tampon qui est null
, GetBytes retourne la longueur du champ en octets.
Aucune conversion n’est effectuée ; par conséquent, les données récupérées doivent déjà être un tableau d’octets.