Méthode SqlCeDataReader.GetChars
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 commençant à l'offset de mémoire tampon donné.
Espace de noms : System.Data.SqlServerCe
Assembly : System.Data.SqlServerCe (en System.Data.SqlServerCe.dll)
Syntaxe
'Déclaration
<SecurityTreatAsSafeAttribute> _
<SecurityCriticalAttribute> _
Public Overrides Function GetChars ( _
ordinal As Integer, _
dataIndex As Long, _
buffer As Char(), _
bufferIndex As Integer, _
length As Integer _
) As Long
'Utilisation
Dim instance As SqlCeDataReader
Dim ordinal As Integer
Dim dataIndex As Long
Dim buffer As Char()
Dim bufferIndex As Integer
Dim length As Integer
Dim returnValue As Long
returnValue = instance.GetChars(ordinal, _
dataIndex, buffer, bufferIndex, length)
[SecurityTreatAsSafeAttribute]
[SecurityCriticalAttribute]
public override long GetChars(
int ordinal,
long dataIndex,
char[] buffer,
int bufferIndex,
int length
)
[SecurityTreatAsSafeAttribute]
[SecurityCriticalAttribute]
public:
virtual long long GetChars(
int ordinal,
long long dataIndex,
array<wchar_t>^ buffer,
int bufferIndex,
int length
) override
[<SecurityTreatAsSafeAttribute>]
[<SecurityCriticalAttribute>]
abstract GetChars :
ordinal:int *
dataIndex:int64 *
buffer:char[] *
bufferIndex:int *
length:int -> int64
[<SecurityTreatAsSafeAttribute>]
[<SecurityCriticalAttribute>]
override GetChars :
ordinal:int *
dataIndex:int64 *
buffer:char[] *
bufferIndex:int *
length:int -> int64
public override function GetChars(
ordinal : int,
dataIndex : long,
buffer : char[],
bufferIndex : int,
length : int
) : long
Paramètres
- ordinal
Type : System.Int32
Ordinal de colonne de base zéro.
- dataIndex
Type : System.Int64
Index figurant dans la ligne à partir de laquelle commencer l'opération de lecture.
- buffer
Type : array<System.Char[]
Mémoire tampon dans laquelle copier les données.
- bufferIndex
Type : System.Int32
Index de buffer auquel commencer l'opération de lecture.
- length
Type : System.Int32
Nombre de caractères à lire.
Valeur de retour
Type : System.Int64
Nombre réel de caractères lus.
Implémente
IDataRecord.GetChars(Int32, Int64, array<Char[], Int32, Int32)
Exceptions
| Exception | Condition |
|---|---|
| InvalidOperationException | L'opération n'est pas valide. Le SqlCeDataReader peut être placé après la dernière ligne dans le jeu de résultats. |
Notes
GetChars retourne le nombre de caractères disponibles dans le champ. Dans la plupart des cas, il s'agit de la longueur exacte du champ. Le nombre retourné risque toutefois d'ê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 SqlCeDataReader lit une structure de données volumineuse dans une mémoire tampon. Pour plus d'informations, consultez le paramètre SequentialAccess de CommandBehavior.
Si vous passez une mémoire tampon ayant la valeur nullune référence Null (Nothing dans Visual Basic), 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.