IDataRecord.GetChars(Int32, Int64, Char[], Int32, Int32) Metodo

Definizione

Legge un flusso di caratteri dall'offset di colonna specificato nel buffer come matrice, a partire dall'offset del buffer specificato.

public:
 long GetChars(int i, long fieldoffset, cli::array <char> ^ buffer, int bufferoffset, int length);
public long GetChars (int i, long fieldoffset, char[] buffer, int bufferoffset, int length);
public long GetChars (int i, long fieldoffset, char[]? buffer, int bufferoffset, int length);
abstract member GetChars : int * int64 * char[] * int * int -> int64
Public Function GetChars (i As Integer, fieldoffset As Long, buffer As Char(), bufferoffset As Integer, length As Integer) As Long

Parametri

i
Int32

Ordinale di colonna in base zero.

fieldoffset
Int64

Indice all'interno della riga da cui avviare l'operazione di lettura.

buffer
Char[]

Buffer in cui leggere il flusso di byte.

bufferoffset
Int32

Indice di buffer per avviare l'operazione di lettura.

length
Int32

Numero di byte da leggere.

Restituisce

Numero effettivo di caratteri letti.

Eccezioni

L'indice passato non era compreso nell'intervallo da 0 a FieldCount.

Commenti

GetChars restituisce il numero di caratteri disponibili nel campo. Spesso si tratta della lunghezza esatta del campo. Tuttavia, il numero restituito può essere minore della lunghezza esatta del campo se GetChars è già stato usato per ottenere caratteri dal campo.

Se si passa un buffer che è null, GetChars restituisce la lunghezza del campo in caratteri.

Non viene eseguita alcuna conversione; pertanto i dati recuperati devono essere già una matrice di caratteri.

Si applica a