Metodo SqlCeDataReader.GetChars
Legge un flusso di caratteri dall'offset di colonna indicato nel buffer come matrice a partire dall'offset del buffer specificato.
Spazio dei nomi System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in System.Data.SqlServerCe.dll)
Sintassi
'Dichiarazione
<SecurityTreatAsSafeAttribute> _
<SecurityCriticalAttribute> _
Public Overrides Function GetChars ( _
ordinal As Integer, _
dataIndex As Long, _
buffer As Char(), _
bufferIndex As Integer, _
length As Integer _
) As Long
'Utilizzo
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
Parametri
- ordinal
Tipo: System.Int32
Ordinale di colonna in base zero.
- dataIndex
Tipo: System.Int64
Indice all'interno della riga dal quale iniziare l'operazione di lettura.
- buffer
Tipo: array<System.Char[]
Buffer in cui copiare i dati.
- bufferIndex
Tipo: System.Int32
Indice per l'oggetto buffer da cui iniziare l'operazione di lettura.
- length
Tipo: System.Int32
Numero di caratteri da leggere.
Valore restituito
Tipo: System.Int64
Numero effettivo di caratteri letti.
Implementa
IDataRecord.GetChars(Int32, Int64, array<Char[], Int32, Int32)
Eccezioni
| Eccezione | Condizione |
|---|---|
| InvalidOperationException | L'operazione non è valida. L'oggetto SqlCeDataReader può essere posizionato dopo l'ultima riga nel set 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 è nullriferimento Null (Nothing in Visual Basic)., 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.