IDataRecord.GetBytes(Int32, Int64, Byte[], Int32, Int32) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
El número real de bytes que se leen.
Excepciones
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.