SqlCeDataReader.GetChars Method

Articolo
01/14/2011

Legge un flusso di caratteri dall'offset di colonna specificato nel buffer, come una matrice che inizia in corrispondenza dell'offset del buffer determinato.

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
Ordinale della colonna in base zero.

dataIndex
Indice all'interno della riga dal quale iniziare l'operazione di lettura.

buffer
Buffer in cui copiare i dati.

bufferIndex
Indice per buffer da cui iniziare l'operazione di lettura.

length
Numero di caratteri da leggere.

Valore restituito

Numero effettivo di caratteri letti.

Eccezioni

Tipo di eccezione	Condizione
InvalidOperationException	L'operazione non è valida. L'oggetto SqlCeDataReader non può essere posizionato dopo l'ultima riga nel gruppo di risultati.

Osservazioni

Il metodo GetChars restituisce il numero di caratteri disponibili nel campo. Nella maggior parte dei casi si tratta della lunghezza esatta del campo. È possibile tuttavia che il numero restituito sia inferiore alla lunghezza del campo se il metodo GetChars è stato già utilizzato per ottenere caratteri dal campo. Questa situazione può verificarsi, ad esempio, quando un'ampia struttura di dati in un buffer viene letta mediante la classe SqlCeDataReader. Per ulteriori informazioni, vedere l'impostazione SequentialAccess relativa all'enumerazione CommandBehavior.

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

Non viene effettuata alcuna conversione, quindi i dati recuperati devono essere già una matrice di caratteri.

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

SqlCeDataReader Class
SqlCeDataReader Members
System.Data.SqlServerCe Namespace

Share via