Condividi tramite


SqlDataRecord.GetBytes(Int32, Int64, Byte[], Int32, Int32) Metodo

Definizione

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 -> int64
Public Overridable Function GetBytes (ordinal As Integer, fieldOffset As Long, buffer As Byte(), bufferOffset As Integer, length As Integer) As Long

Parametri

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.

Si applica a