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.Reads a stream of characters from the specified column offset into the buffer as an array, starting at the given buffer offset.

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);
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.The zero-based column ordinal.

fieldoffset
Int64

Indice all'interno della riga da cui avviare l'operazione di lettura.The index within the row from which to start the read operation.

buffer
Char[]

Buffer in cui leggere il flusso di byte.The buffer into which to read the stream of bytes.

bufferoffset
Int32

Indice di buffer per avviare l'operazione di lettura.The index for buffer to start the read operation.

length
Int32

Numero di byte da leggere.The number of bytes to read.

Restituisce

Numero effettivo di caratteri letti.The actual number of characters read.

Eccezioni

L'indice passato non era compreso nell'intervallo da 0 a FieldCount.The index passed was outside the range of 0 through FieldCount.

Commenti

GetChars restituisce il numero di caratteri disponibili nel campo.GetChars returns the number of available characters in the field. Spesso si tratta della lunghezza esatta del campo.Frequently this is the exact length of the field. Tuttavia, il numero restituito può essere inferiore alla lunghezza esatta del campo se GetChars è già stato utilizzato per ottenere i caratteri dal campo.However, the number returned may be less than the exact length of the field if GetChars has already been used to obtain characters from the field.

Se si passa un buffer null, GetChars restituisce la lunghezza del campo in caratteri.If you pass a buffer that is null, GetChars returns the length of the field in characters.

Non viene eseguita alcuna conversione; pertanto i dati recuperati devono essere già una matrice di caratteri.No conversions are performed; therefore the data retrieved must already be a character array.

Si applica a