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

Definizione

Spazio dei nomi:

System.Data

Assembly:

System.Data.Common.dll

Assembly:

System.Data.dll

Assembly:

netstandard.dll

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

Int64

Numero effettivo di caratteri letti.

Eccezioni

IndexOutOfRangeException

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.