Méthode SqlCeResultSet.GetChars

Copie une longueur de caractères dans la mémoire tampon, en démarrant à une position spécifiée dans le champ spécifié.

Espace de noms :  System.Data.SqlServerCe
Assembly :  System.Data.SqlServerCe (en System.Data.SqlServerCe.dll)

Syntaxe

'Déclaration
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 SqlCeResultSet
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)
public override long GetChars(
    int ordinal,
    long dataIndex,
    char[] buffer,
    int bufferIndex,
    int length
)
public:
virtual long long GetChars(
    int ordinal, 
    long long dataIndex, 
    array<wchar_t>^ buffer, 
    int bufferIndex, 
    int length
) override
abstract GetChars : 
        ordinal:int * 
        dataIndex:int64 * 
        buffer:char[] * 
        bufferIndex:int * 
        length:int -> int64 
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
    Position ordinale du champ à partir duquel récupérer les données.
  • dataIndex
    Type : System.Int64
    Offset (en caractères) du champ à partir duquel commencer la copie des données.
  • buffer
    Type : array<System.Char[]
    Mémoire tampon dans laquelle copier les données.
  • bufferIndex
    Type : System.Int32
    Offset de la mémoire tampon à partir duquel démarrer la copie.
  • length
    Type : System.Int32
    Nombre maximal d'octets à copier.

Valeur de retour

Type : System.Int64
Nombre réel de caractères copiés.

Implémente

IDataRecord.GetChars(Int32, Int64, array<Char[], Int32, Int32)

Notes

Cette fonction retourne le nombre réel de caractères copiés, qui peut être inférieur à la longueur demandée si la fin du champ est atteinte.

Si vous passez une mémoire tampon null, GetChars retourne la longueur du champ, en caractères.

Si la commande est exécutée avec un comportement SequentialAccess, les appels à GetChars doivent spécifier des lectures à croissance séquentielle ; sinon, une exception est levée.

Une exception est levée si aucun champ n'existe à la position ordinale spécifiée.

Voir aussi

Référence

SqlCeResultSet Classe

Espace de noms System.Data.SqlServerCe