SqlDataRecord.GetBytes(Int32, Int64, Byte[], 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 Byte.
public:
virtual long GetBytes(int ordinal, long fieldOffset, cli::array <System::Byte> ^ buffer, int bufferOffset, int length);public virtual long GetBytes (int ordinal, long fieldOffset, byte[] buffer, int bufferOffset, int length);abstract member GetBytes : int * int64 * byte[] * int * int -> int64
override this.GetBytes : int * int64 * byte[] * int * int -> int64Public Overridable Function GetBytes (ordinal As Integer, fieldOffset As Long, buffer As Byte(), 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 byte.
- buffer
- Byte[]
Buffer di destinazione in cui copiare i byte.
- bufferOffset
- Int32
Offset nel buffer da cui iniziare a copiare i byte.
- length
- Int32
Numero di byte da copiare nel buffer.
Restituisce
Numero di byte 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 binario 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 di byte della dimensione del blocco e chiamare GetBytes ripetutamente, modificando il fieldOffset parametro di conseguenza in ogni chiamata.