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

Définition

Espace de noms:
System.Data.Odbc
Assembly:
System.Data.Odbc.dll
Assembly:
System.Data.dll
Paquet:
System.Data.Odbc v11.0.0-preview.4.26230.115
Source:
OdbcDataReader.cs
Source:
OdbcDataReader.cs
Source:
OdbcDataReader.cs
Source:
OdbcDataReader.cs

Lit un flux de caractères du décalage de colonne spécifié dans la mémoire tampon en tant que tableau, en commençant par le décalage de mémoire tampon particulier.

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

Ordinal de colonne de base zéro.

dataIndex
Int64

Index dans la ligne où l’opération de lecture doit démarrer.

buffer
Char[]

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

bufferIndex
Int32

Index dans l’emplacement buffer où l’opération d’écriture doit démarrer.

length
Int32

Nombre de caractères à lire.

Retours

Int64

Nombre réel de caractères lus.

Implémente

GetChars(Int32, Int64, Char[], Int32, Int32)

Remarques

GetChars retourne le nombre de caractères disponibles dans le champ. La plupart du temps, c’est la longueur exacte du champ. Toutefois, le nombre retourné peut être inférieur à la longueur réelle du champ s’il GetChars a déjà été utilisé pour obtenir des caractères à partir du champ. Il peut s’agir, par exemple, de la OdbcDataReader lecture d’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.

Note

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

S’applique à

Voir aussi