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

Definizione

Legge un flusso di byte dall'offset di colonna specificato nel buffer come matrice, a partire dall'offset del buffer specificato.Reads a stream of bytes from the specified column offset into the buffer as an array, starting at the given buffer offset.

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);
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.The zero-based column ordinal.

fieldOffset
Int64

Indice all'interno del campo da cui avviare l'operazione di lettura.The index within the field from which to start the read operation.

buffer
Byte[]

Buffer in cui leggere il flusso di byte.The buffer into which to read the stream of bytes.

bufferoffset
Int32

Indice di buffer per avviare l'operazione di lettura.The index for buffer to start the read operation.

length
Int32

Numero di byte da leggere.The number of bytes to read.

Restituisce

Numero effettivo di byte letti.The actual number of bytes read.

Eccezioni

L'indice passato non era compreso nell'intervallo da 0 a FieldCount.The index passed was outside the range of 0 through FieldCount.

Commenti

GetBytes restituisce il numero di byte disponibili nel campo.GetBytes returns the number of available bytes in the field. Spesso si tratta della lunghezza esatta del campo.Frequently this is the exact length of the field. Tuttavia, il numero restituito può essere minore della lunghezza effettiva del campo se GetBytes è già stato utilizzato per ottenere i byte dal campo.However, the number returned may be less than the true length of the field if GetBytes has already been used to obtain bytes from the field.

Se si passa un buffer null, GetBytes restituisce la lunghezza della riga in byte.If you pass a buffer that is null, GetBytes returns the length of the row in bytes.

Non vengono eseguite conversioni; Pertanto, i dati recuperati devono essere già una matrice di byte.No conversions are performed; therefore the data retrieved must already be a byte array.

Si applica a