Partilhar via


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

Definição

Lê um fluxo de bytes no deslocamento de coluna especificado no buffer como uma matriz, iniciando no deslocamento de buffer especificado.

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

O ordinal da coluna baseado em zero.

dataIndex
Int64

O índice no campo no qual será iniciada a operação de leitura.

buffer
Byte[]

O buffer no qual o fluxo de bytes deve ser lido.

bufferIndex
Int32

O índice dentro de buffer no qual a operação de gravação deve ser iniciada.

length
Int32

O tamanho máximo a ser copiado no buffer.

Retornos

O número real de bytes lidos.

Implementações

Comentários

GetBytes retorna o número de bytes disponíveis no campo. Na maioria das vezes, esse é o comprimento exato do campo. No entanto, o número retornado poderá ser menor que o comprimento verdadeiro do campo se GetBytes já tiver sido usado para obter bytes do campo. Esse pode ser o caso, por exemplo, quando o OleDbDataReader está lendo uma estrutura de dados grande em um buffer. Para obter mais informações, consulte a SequentialAccess configuração para CommandBehavior.

Se você passar um buffer que seja null, GetBytes retornará o comprimento do campo em bytes.

Nenhuma conversão é executada; portanto, os dados recuperados já devem ser uma matriz de bytes.

Aplica-se a

Confira também