OleDbDataReader.GetBytes(Int32, Int64, Byte[], Int32, Int32) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Lê um fluxo de bytes do deslocamento de coluna especificado para o buffer como um array a partir do deslocamento do buffer dado.
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, cli::array <System::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);
abstract member GetBytes : int * int64 * byte[] * int * int -> int64
override this.GetBytes : int * int64 * byte[] * int * int -> int64
override this.GetBytes : int * int64 * byte[] * int * int -> int64
Public Function GetBytes (ordinal As Integer, dataIndex As Long, buffer As Byte(), bufferIndex As Integer, length As Integer) As Long
Public Overrides Function GetBytes (ordinal As Integer, dataIndex As Long, buffer As Byte(), bufferIndex As Integer, length As Integer) As Long
Parâmetros
- ordinal
- Int32
O ordinal da coluna baseada em zero.
- dataIndex
- Int64
O índice dentro do campo a partir do qual iniciar a operação de leitura.
- buffer
- Byte[]
O buffer para ler o fluxo de bytes.
- bufferIndex
- Int32
O índice dentro do buffer local onde a operação de escrita deve começar.
- length
- Int32
O comprimento máximo para copiar para o buffer.
Devoluções
O número real de bytes lidos.
Implementações
Observações
GetBytes devolve o número de bytes disponíveis no campo. Na maioria das vezes, este é exatamente o comprimento do campo. No entanto, o número devolvido pode ser inferior ao comprimento verdadeiro do campo se GetBytes já tiver sido usado para obter bytes do campo. Isto pode acontecer, por exemplo, quando está OleDbDataReader a ler uma grande estrutura de dados num buffer. Para mais informações, consulte a SequentialAccess definição para CommandBehavior.
Se passar um buffer que é null, GetBytes devolve o comprimento do campo em bytes.
Não são realizadas conversões; Portanto, os dados recuperados já devem ser um array de bytes.