IDataRecord.GetBytes(Int32, Int64, Byte[], Int32, Int32) Método

Definición

Lee una secuencia de bytes del desplazamiento de columna especificado en el búfer como una matriz, comenzando en el desplazamiento de búfer dado.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

Parámetros

i
Int32

Índice de la columna de base cero.The zero-based column ordinal.

fieldOffset
Int64

Índice del campo a partir del cual se va a comenzar la operación de lectura.The index within the field from which to start the read operation.

buffer
Byte[]

Búfer en el que se va a leer la secuencia de bytes.The buffer into which to read the stream of bytes.

bufferoffset
Int32

Índice de buffer para iniciar la operación de lectura.The index for buffer to start the read operation.

length
Int32

Número de bytes que se va a leer.The number of bytes to read.

Devoluciones

El número real de bytes que se leen.The actual number of bytes read.

Excepciones

El índice pasado se encontraba fuera del intervalo de 0 a FieldCount.The index passed was outside the range of 0 through FieldCount.

Comentarios

GetBytes devuelve el número de bytes disponibles en el campo.GetBytes returns the number of available bytes in the field. Con frecuencia, es la longitud exacta del campo.Frequently this is the exact length of the field. Sin embargo, el número devuelto puede ser menor que la longitud real del campo si ya se ha utilizado GetBytes para obtener bytes del 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.

Si se pasa un búfer null, GetBytes devuelve la longitud de la fila en bytes.If you pass a buffer that is null, GetBytes returns the length of the row in bytes.

No se realizan conversiones; por lo tanto, los datos recuperados deben ser ya una matriz de bytes.No conversions are performed; therefore the data retrieved must already be a byte array.

Se aplica a