IDataRecord.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 comme un tableau, en commençant à l’offset de mémoire tampon donné.
public:
long GetBytes(int i, long fieldOffset, cli::array <System::Byte> ^ buffer, int bufferoffset, int length);public long GetBytes (int i, long fieldOffset, byte[] buffer, int bufferoffset, int length);public long GetBytes (int i, long fieldOffset, byte[]? buffer, int bufferoffset, int length);abstract member GetBytes : int * int64 * byte[] * int * int -> int64Public Function GetBytes (i As Integer, fieldOffset As Long, buffer As Byte(), bufferoffset As Integer, length As Integer) As LongParamètres
- i
- Int32
Numéro de colonne de base zéro.
- fieldOffset
- 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.
- bufferoffset
- Int32
L’index pour que buffer démarre l’opération de lecture.
- length
- Int32
Nombre d'octets à lire.
Retours
Nombre réel d'octets lus.
Exceptions
L’index passé était en dehors de la plage comprise entre 0 et FieldCount.
Remarques
GetBytes retourne le nombre d’octets disponibles dans le champ. Il s’agit souvent 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.
Si vous transmettez une mémoire tampon qui est null, GetBytes retourne la longueur de la ligne 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.
