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

  • Référence

Définition

Espace de noms:
System.Data
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll

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 -> int64
Public Function GetBytes (i As Integer, fieldOffset As Long, buffer As Byte(), bufferoffset As Integer, length As Integer) As Long

Paramè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

Int64

Nombre réel d'octets lus.

Exceptions

IndexOutOfRangeException

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.

S’applique à