IDataRecord.GetBytes(Int32, Int64, Byte[], Int32, Int32) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 -> int64Public Function GetBytes (i As Integer, fieldOffset As Long, buffer As Byte(), bufferoffset As Integer, length As Integer) As LongParâ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.
