Partager via


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

Définition

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

Nombre réel de caractères lus.

Implémente

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.

S’applique à