Partager via


OleDbDataReader.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 ordinal, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);
public:
 virtual long GetChars(int ordinal, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);
public override long GetChars (int ordinal, long dataIndex, char[]? buffer, int bufferIndex, int length);
public long GetChars (int ordinal, long dataIndex, char[] buffer, int bufferIndex, int length);
public override long GetChars (int ordinal, long dataIndex, char[] buffer, int bufferIndex, int length);
override this.GetChars : int * int64 * char[] * int * int -> int64
abstract member GetChars : int * int64 * char[] * int * int -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64
Public Overrides Function GetChars (ordinal As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long
Public Function GetChars (ordinal As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long

Paramètres

ordinal
Int32

Numéro de colonne de base zéro.

dataIndex
Int64

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

buffer
Char[]

Mémoire tampon dans laquelle copier les données.

bufferIndex
Int32

Index figurant dans le buffer où doit commencer l'opération d'écriture.

length
Int32

Nombre de caractères à lire.

Retours

Nombre réel de caractères lus.

Implémente

Remarques

GetChars retourne le nombre de caractères disponibles dans le champ. La plupart du temps, il s’agit 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, lorsque le OleDbDataReader lit une structure de données volumineuse dans une mémoire tampon. Pour plus d’informations, consultez le SequentialAccess paramètre pour CommandBehavior.

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 à

Voir aussi