SqlDataRecord.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.
Ottiene il valore per la colonna specificata dall'ordinale come matrice di oggetti Char.
public:
virtual long GetChars(int ordinal, long fieldOffset, cli::array <char> ^ buffer, int bufferOffset, int length);public virtual long GetChars (int ordinal, long fieldOffset, char[] buffer, int bufferOffset, int length);abstract member GetChars : int * int64 * char[] * int * int -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64Public Overridable Function GetChars (ordinal As Integer, fieldOffset As Long, buffer As Char(), bufferOffset As Integer, length As Integer) As LongParametri
- ordinal
- Int32
Ordinale in base zero della colonna.
- fieldOffset
- Int64
Offset nel valore del campo per avviare il recupero dei caratteri.
- buffer
- Char[]
Buffer di destinazione in cui copiare i caratteri.
- bufferOffset
- Int32
Offset nel buffer a partire in cui iniziare a copiare i caratteri.
- length
- Int32
Numero di caratteri da copiare nel buffer.
Restituisce
Numero di caratteri copiati.
Implementazioni
Eccezioni
ordinal è minore di 0 o maggiore del numero di colonne, ovvero FieldCount.
La colonna specificata da ordinal è Null.
I tipi non corrispondono.
Commenti
Questo metodo consente di ottenere un valore di carattere in una singola chiamata o in blocchi. Ottenere il valore in blocchi è utile per valori di grandi dimensioni o valori di dimensioni sconosciute.
Per ottenere il valore in diversi blocchi, allocare una matrice char della dimensione blocchi e chiamare GetChars ripetutamente modificando il fieldOffset parametro di conseguenza in ogni chiamata.