SqlDataRecord.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.
Obtém o valor da coluna especificada pelo ordinal como uma matriz de objetos Byte.
public:
virtual long GetBytes(int ordinal, long fieldOffset, cli::array <System::Byte> ^ buffer, int bufferOffset, int length);public virtual long GetBytes (int ordinal, long fieldOffset, byte[] buffer, int bufferOffset, int length);abstract member GetBytes : int * int64 * byte[] * int * int -> int64
override this.GetBytes : int * int64 * byte[] * int * int -> int64Public Overridable Function GetBytes (ordinal As Integer, fieldOffset As Long, buffer As Byte(), bufferOffset As Integer, length As Integer) As LongParâmetros
- ordinal
- Int32
O ordinal com base em zero da coluna.
- fieldOffset
- Int64
O deslocamento no valor do campo para começar a recuperar bytes.
- buffer
- Byte[]
O buffer de destino no qual copiar bytes.
- bufferOffset
- Int32
O deslocamento no buffer no qual começar a copiar bytes.
- length
- Int32
O número de bytes a serem copiados no buffer.
Retornos
O número de bytes copiados.
Implementações
Exceções
O ordinal é menor que 0 ou maior que o número de colunas (ou seja, FieldCount).
A coluna especificada por ordinal é nula.
Há tipos incompatíveis.
Comentários
Esse método permite que você obtenha um valor binário em uma única chamada ou em partes. Obter o valor em partes é útil para valores grandes ou valores de tamanho desconhecido.
Para obter o valor em várias partes, aloque uma matriz de bytes do tamanho da parte e chame GetBytes repetidamente, ajustando o fieldOffset parâmetro adequadamente em cada chamada.