SqlCeResultSet.GetChars Method

Articolo
01/14/2011

Copia una lunghezza di caratteri nel buffer, a partire dalla posizione specificata nel campo specificato.

Spazio dei nomi: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in system.data.sqlserverce.dll)

Sintassi

'Dichiarazione
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

Parametri

ordinal
Posizione ordinale del campo da cui recuperare i dati.

dataIndex
Offset (in caratteri) all'interno del campo da cui iniziare a copiare.

buffer
Buffer in cui copiare i dati.

bufferIndex
Offset all'interno del buffer da cui iniziare la copia.

length
Numero massimo di byte da copiare.

Valore restituito

Numero effettivo di caratteri copiati.

Osservazioni

Questa funzione restituisce il numero effettivo di caratteri copiati, che può essere inferiore alla lunghezza richiesta se viene raggiunta la fine del campo.

Se si passa un buffer con valore null, il metodo GetChars restituisce la lunghezza del campo espressa in caratteri.

Se il comando viene eseguito con l'impostazione SequentialAccess, nelle chiamate al metodo GetChars è necessario specificare letture con incrementi sequenziali. In caso contrario, viene generata un'eccezione.

Se nella posizione ordinale specificata non è presente alcun campo, viene generata un'eccezione.

Affidabilità

Tutti i membri statici pubblici (Shared in Microsoft Visual Basic) di questo tipo sono affidabili. Non è invece garantita l'affidabilità dei membri dell'istanza.

Piattaforme

Piattaforme di sviluppo

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
Informazioni sulla versione
.NET Framework e .NET Compact Framework
Supportato in 3.5
.NET Framework
Supportato in 3.0
.NET Compact Framework e .NET Framework
Supportato in 2.0

Vedere anche

Riferimento

SqlCeResultSet Class
SqlCeResultSet Members
System.Data.SqlServerCe Namespace

Condividi tramite