Partager via


IDataRecord.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 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);
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

Nombre réel de caractères lus.

Exceptions

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.

S’applique à