Méthode AdomdDataReader.GetChars
Retourne un tableau d'objets Char qui contient un flux de valeurs de la colonne spécifiée.
Espace de noms : Microsoft.AnalysisServices.AdomdServer
Assembly : msmgdsrv (en msmgdsrv.dll)
Syntaxe
'Déclaration
Public Function GetChars ( _
i As Integer, _
fieldOffset As Long, _
buffer As Char(), _
bufferoffset As Integer, _
length As Integer _
) As Long
'Utilisation
Dim instance As AdomdDataReader
Dim i As Integer
Dim fieldOffset As Long
Dim buffer As Char()
Dim bufferoffset As Integer
Dim length As Integer
Dim returnValue As Long
returnValue = instance.GetChars(i, fieldOffset, _
buffer, bufferoffset, length)
public long GetChars(
int i,
long fieldOffset,
char[] buffer,
int bufferoffset,
int length
)
public:
virtual long long GetChars(
int i,
long long fieldOffset,
array<wchar_t>^ buffer,
int bufferoffset,
int length
) sealed
abstract GetChars :
i:int *
fieldOffset:int64 *
buffer:char[] *
bufferoffset:int *
length:int -> int64
override GetChars :
i:int *
fieldOffset:int64 *
buffer:char[] *
bufferoffset:int *
length:int -> int64
public final function GetChars(
i : int,
fieldOffset : long,
buffer : char[],
bufferoffset : int,
length : int
) : long
Paramètres
- i
Type : Int32
Position ordinale de base zéro de la colonne à récupérer.
- fieldOffset
Type : Int64
Index de base zéro dans la colonne à partir duquel la lecture de données commence.
- buffer
Type : array<Char[]
Mémoire tampon dans laquelle le flux de caractères est lu.
- bufferoffset
Type : Int32
Index de base zéro dans la mémoire tampon à partir duquel l'écriture de données commence.
- length
Type : Int32
Nombre de caractères à lire depuis la colonne.
Valeur de retour
Type : Int64
Type de données Long qui contient le nombre de caractères lus réellement depuis la colonne.
Implémente
IDataRecordGetChars(Int32, Int64, Char, Int32, Int32)
Exceptions
| Exception | Condition |
|---|---|
| [IndexOutOfRangeException] | La valeur de dataIndex est supérieure à Int32.MaxValue. La valeur de bufferIndex est inférieure à 0 ou supérieure au total de length et à la longueur de buffer. Pour plus d'informations sur cette exception, consultez IndexOutOfRangeException Class. |
Notes
La méthode GetChars retourne le nombre de caractères disponibles dans le domaine. Dans la plupart des cas, c'est 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 les caractères du champ.
Si vous passez une référence Null (Nothing en Microsoft Visual Basic) dans le paramètre buffer, GetBytes retourne la longueur de la colonne en caractères.
Aucune conversion n'est effectuée ; par conséquent, les données récupérées doivent être déjà un tableau de caractères.