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

Définition

Espace de noms:

System.Data

Assembly:

System.Data.Common.dll

Lit un flux de caractères à 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 GetChars(int i, long fieldoffset, cli::array <char> ^ buffer, int bufferoffset, int length);

public long GetChars (int i, long fieldoffset, char[]? buffer, int bufferoffset, int length);

abstract member GetChars : int * int64 * char[] * int * int -> int64

Public Function GetChars (i As Integer, fieldoffset As Long, buffer As Char(), bufferoffset As Integer, length As Integer) As Long

Paramètres

i

Int32

Numéro de colonne de base zéro.

fieldoffset

Int64

Index figurant dans la ligne à partir de laquelle lancer l'opération de lecture.

buffer

Char[]

La mémoire tampon dans laquelle lire le flux d’octets.

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 de caractères lus.

Exceptions

IndexOutOfRangeException

L’index passé était en dehors de la plage comprise entre 0 et FieldCount.

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 exacte du champ si GetChars a déjà été utilisé pour obtenir des caractères à partir du champ.

Si vous passez une mémoire tampon qui est null, GetChars retourne la longueur du champ en caractères.

Aucune conversion n'est effectuée ; par conséquent, les données récupérées doivent déjà être un tableau de caractères.