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

  • Riferimento

Definizione

Spazio dei nomi:
System.Data
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll

Legge un flusso di byte dall'offset di colonna specificato nel buffer come matrice, a partire dall'offset del buffer specificato.

public:
 long GetBytes(int i, long fieldOffset, cli::array <System::Byte> ^ buffer, int bufferoffset, int length);
public long GetBytes (int i, long fieldOffset, byte[] buffer, int bufferoffset, int length);
public long GetBytes (int i, long fieldOffset, byte[]? buffer, int bufferoffset, int length);
abstract member GetBytes : int * int64 * byte[] * int * int -> int64
Public Function GetBytes (i As Integer, fieldOffset As Long, buffer As Byte(), bufferoffset As Integer, length As Integer) As Long

Parametri

i
Int32

Ordinale di colonna in base zero.

fieldOffset
Int64

Indice all'interno del campo da cui avviare l'operazione di lettura.

buffer
Byte[]

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

Int64

Numero effettivo di byte letti.

Eccezioni

IndexOutOfRangeException

L'indice passato non era compreso nell'intervallo da 0 a FieldCount.

Commenti

GetBytes restituisce il numero di byte disponibili nel campo. Spesso si tratta della lunghezza esatta del campo. Tuttavia, il numero restituito può essere minore della lunghezza effettiva del campo se GetBytes è già stato usato per ottenere byte dal campo.

Se si passa un buffer che è null, GetBytes restituisce la lunghezza della riga in byte.

Non vengono eseguite conversioni; pertanto i dati recuperati devono essere già una matrice di byte.

Si applica a