Compartilhar via


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

Definição

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 -> int64
Public Overridable Function GetBytes (ordinal As Integer, fieldOffset As Long, buffer As Byte(), bufferOffset As Integer, length As Integer) As Long

Parâ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.

Aplica-se a