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

Définition

Espace de noms:
System.Data.SqlClient
Assembly:
System.Data.dll

Lit un flux d’octets du décalage de colonne spécifié dans la mémoire tampon d’un tableau commençant par le décalage de mémoire tampon donné.

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, cli::array <System::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);
abstract member GetBytes : int * int64 * byte[] * int * int -> int64
override this.GetBytes : int * int64 * byte[] * int * int -> int64
override this.GetBytes : int * int64 * byte[] * int * int -> int64
Public Function GetBytes (i As Integer, dataIndex As Long, buffer As Byte(), bufferIndex As Integer, length As Integer) As Long
Public Overrides 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 à partir duquel commencer l’opération de lecture.

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

Longueur maximale à copier dans la mémoire tampon.

Retours

Int64

Nombre réel d’octets lus.

Implémente

GetBytes(Int32, Int64, Byte[], Int32, Int32)

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 SqlDataReader 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 null, GetBytes retourne la longueur du champ entier en octets, et non la taille restante en fonction du paramètre de décalage de mémoire tampon.

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 à

Voir aussi