IDataRecord.GetChars(Int32, Int64, Char[], Int32, Int32) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 -> int64Public Function GetChars (i As Integer, fieldoffset As Long, buffer As Char(), bufferoffset As Integer, length As Integer) As LongParamè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.
