SqlDataRecord.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.
Obtient la valeur de la colonne spécifiée par l’ordinal en tant que tableau d’objets Char.
public:
virtual long GetChars(int ordinal, long fieldOffset, cli::array <char> ^ buffer, int bufferOffset, int length);public virtual long GetChars (int ordinal, long fieldOffset, char[] buffer, int bufferOffset, int length);abstract member GetChars : int * int64 * char[] * int * int -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64Public Overridable Function GetChars (ordinal As Integer, fieldOffset As Long, buffer As Char(), bufferOffset As Integer, length As Integer) As LongParamètres
- ordinal
- Int32
Numéro en base zéro de la colonne.
- fieldOffset
- Int64
Offset dans la valeur de champ qui détermine où commencer la récupération des caractères.
- buffer
- Char[]
Mémoire tampon cible dans laquelle copier les caractères.
- bufferOffset
- Int32
Offset dans la mémoire tampon vers lequel commencer la copie des caractères.
- length
- Int32
Nombre de caractères à copier dans la mémoire tampon.
Retours
Nombre de caractères copiés.
Implémente
Exceptions
ordinal est inférieur à 0 ou supérieur au nombre de colonnes (soit FieldCount).
La colonne spécifiée par ordinal est Null.
Il existe une incompatibilité de type.
Remarques
Cette méthode vous permet d’obtenir une valeur de caractère en un seul appel ou en blocs. L’obtention de la valeur en blocs est utile pour les valeurs volumineuses ou de taille inconnue.
Pour obtenir la valeur en plusieurs blocs, allouez un tableau de caractères de la taille du bloc et appelez GetChars à plusieurs reprises en ajustant le fieldOffset paramètre en conséquence dans chaque appel.