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

  • Referencia

Definición

Espacio de nombres:
System.Data
Ensamblado:
System.Data.Common.dll
Ensamblado:
System.Data.dll
Ensamblado:
netstandard.dll

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.

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

Parámetros

i
Int32

Índice de la columna de base cero.

fieldOffset
Int64

Índice del campo a partir del cual se va a comenzar la operación de lectura.

buffer
Byte[]

Búfer en el que se va a leer la secuencia de bytes.

bufferoffset
Int32

Índice de buffer para iniciar la operación de lectura.

length
Int32

Número de bytes que se va a leer.

Devoluciones

Int64

El número real de bytes que se leen.

Excepciones

IndexOutOfRangeException

El índice pasado se encontraba fuera del intervalo de 0 a FieldCount.

Comentarios

GetBytes devuelve el número de bytes disponibles en el campo . Con frecuencia, esta es la longitud exacta del campo. Sin embargo, el número devuelto puede ser menor que la longitud verdadera del campo si GetBytes ya se ha usado para obtener bytes del campo.

Si pasa un búfer que es null, GetBytes devuelve la longitud de la fila en bytes.

No se realizan conversiones; por lo tanto, los datos recuperados ya deben ser una matriz de bytes.

Se aplica a