OleDbDataReader.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 la columna especificada en el búfer como matriz, comenzando en el desplazamiento de búfer dado.
public:
override long GetBytes(int ordinal, long dataIndex, cli::array <System::Byte> ^ buffer, int bufferIndex, int length);
public:
virtual long GetBytes(int ordinal, long dataIndex, cli::array <System::Byte> ^ buffer, int bufferIndex, int length);
public override long GetBytes (int ordinal, long dataIndex, byte[]? buffer, int bufferIndex, int length);
public long GetBytes (int ordinal, long dataIndex, byte[] buffer, int bufferIndex, int length);
public override long GetBytes (int ordinal, long dataIndex, byte[] buffer, int bufferIndex, int length);
override this.GetBytes : int * int64 * byte[] * int * int -> int64
abstract member GetBytes : int * int64 * byte[] * int * int -> int64
override this.GetBytes : int * int64 * byte[] * int * int -> int64
Public Overrides Function GetBytes (ordinal As Integer, dataIndex As Long, buffer As Byte(), bufferIndex As Integer, length As Integer) As Long
Public Function GetBytes (ordinal As Integer, dataIndex As Long, buffer As Byte(), bufferIndex As Integer, length As Integer) As Long
Parámetros
- ordinal
- Int32
Índice de la columna de base cero.
- dataIndex
- 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.
- bufferIndex
- Int32
Índice del buffer
donde va a comenzar la operación de escritura.
- length
- Int32
Longitud máxima que se puede copiar en el búfer.
Devoluciones
El número real de bytes que se leen.
Implementaciones
Comentarios
GetBytes devuelve el número de bytes disponibles en el campo . La mayoría de las veces 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. Esto puede ser el caso, por ejemplo, cuando está OleDbDataReader leyendo una estructura de datos grande en un búfer. Para obtener más información, vea la SequentialAccess
configuración de CommandBehavior.
Si pasa un búfer que es null
, GetBytes devuelve la longitud del campo en bytes.
No se realizan conversiones; Por lo tanto, los datos recuperados ya deben ser una matriz de bytes.