SqlDataReader.GetChars(Int32, Int64, Char[], Int32, Int32) Méthode

Définition

Espace de noms:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paquet:

Microsoft.Data.SqlClient v5.2.0

Lit un flux de caractères à partir de l’offset de colonne spécifié dans la mémoire tampon sous la forme d’un tableau, en commençant à l’offset de mémoire tampon donné.

public:
 override long GetChars(int i, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);

public override long GetChars (int i, long dataIndex, char[] buffer, int bufferIndex, int length);

override this.GetChars : int * int64 * char[] * int * int -> int64

Public Overrides Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long

Paramètres

i

Int32

Numéro de colonne de base zéro.

dataIndex

Int64

Index dans le champ à partir duquel commencer l’opération de lecture.

buffer

Char[]

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

Int64

Nombre réel de caractères lus.

Implémente

GetChars(Int32, Int64, Char[], Int32, Int32)

Remarques

GetChars retourne le nombre de caractères 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 GetChars a déjà été utilisé pour obtenir des caractères à partir du champ. Cela peut être le cas, par exemple, si le SqlDataReader lit une structure de données volumineuse dans une mémoire tampon. Pour plus d’informations, consultez le SequentialAccess paramètre pour CommandBehavior.

Le nombre réel de caractères lus peut être inférieur à la longueur demandée, si la fin du champ est atteinte. Si vous transmettez une mémoire tampon qui est null, GetChars retourne la longueur du champ entier en caractères, et non la taille restante en fonction du paramètre de décalage de la mémoire tampon.

Aucune conversion n’est effectuée ; Donc. les données récupérées doivent déjà être un tableau de caractères.

Notes

La GetChars méthode retourne 0 quand dataIndex est négatif.