Partager via


SqlCeResultSet.GetChars Method

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 (dans 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
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
public long GetChars (
    int ordinal, 
    long dataIndex, 
    char[] buffer, 
    int bufferIndex, 
    int length
)
public override function GetChars (
    ordinal : int, 
    dataIndex : long, 
    buffer : char[], 
    bufferIndex : int, 
    length : int
) : long

Paramètres

  • ordinal
    Position ordinale du champ à partir duquel récupérer les données.
  • dataIndex
    Offset (en caractères) du champ à partir duquel commencer la copie des données.
  • buffer
    Mémoire tampon dans laquelle copier les données.
  • bufferIndex
    Offset de la mémoire tampon à partir duquel démarrer la copie.
  • length
    Nombre maximal d'octets à copier.

Valeur de retour

Nombre réel de caractères copiés.

Remarques

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.

Sécurité des threads

Tout membre statique public (Partagé dans Microsoft Visual Basic) de ce type sont thread-safe. Tous les membres de l'instance ne sont pas garantis comme sûrs.

Plateformes

Plateformes de développement

Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
Informations sur la version
.NET Framework et NET Compact Framework
Pris en charge dans 3.5
.NET Framework
Pris en charge dans 3.0
.NET Compact Framework et .Net Framework
Pris en charge dans 2.0

Voir aussi

Référence

SqlCeResultSet Class
SqlCeResultSet Members
System.Data.SqlServerCe Namespace