IDataRecord.GetChars(Int32, Int64, Char[], Int32, Int32) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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.