Partager via


OdbcDataReader.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 spécifique.

public:
 override long GetChars(int i, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);
public:
 virtual 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);
public long GetChars (int i, long dataIndex, 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
abstract member GetChars : int * int64 * char[] * int * int -> int64
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
Public 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 figurant dans la ligne où doit commencer 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, si le OdbcDataReader 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 une valeur null, GetChars retourne la longueur du champ en caractères.

Les conversions sont effectuées en fonction des fonctionnalités sous-jacentes du pilote ODBC. Si la conversion n’est pas prise en charge, l’appel de méthode échoue.

Notes

Aucune exception n’est levée si la valeur de bufferIndex est en dehors du tableau. Aucune donnée n’est lue et la méthode retourne 0.

S’applique à

Voir aussi