Compartilhar via


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

Definição

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

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

O ordinal da coluna baseado em zero.

fieldOffset
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.

bufferoffset
Int32

O índice para o buffer para iniciar a operação de leitura.

length
Int32

O número de bytes a serem lidos.

Retornos

O número real de bytes lidos.

Exceções

O índice passado estava fora do intervalo de 0 a FieldCount.

Comentários

GetBytes retorna o número de bytes disponíveis no campo . Frequentemente, 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.

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

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

Aplica-se a