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

Definição

Espaço de Nomes:
System.Data.SqlClient
Assemblagem:
System.Data.dll

Lê um fluxo de bytes do deslocamento da coluna especificado para o buffer, um array começando no deslocamento do buffer dado.

public:
 virtual long GetBytes(int i, long dataIndex, cli::array <System::Byte> ^ buffer, int bufferIndex, int length);
public:
 override long GetBytes(int i, long dataIndex, cli::array <System::Byte> ^ buffer, int bufferIndex, int length);
public long GetBytes(int i, long dataIndex, byte[] buffer, int bufferIndex, int length);
public override long GetBytes(int i, long dataIndex, byte[] buffer, int bufferIndex, int length);
abstract member GetBytes : int * int64 * byte[] * int * int -> int64
override this.GetBytes : int * int64 * byte[] * int * int -> int64
override this.GetBytes : int * int64 * byte[] * int * int -> int64
Public Function GetBytes (i As Integer, dataIndex As Long, buffer As Byte(), bufferIndex As Integer, length As Integer) As Long
Public Overrides Function GetBytes (i As Integer, dataIndex As Long, buffer As Byte(), bufferIndex As Integer, length As Integer) As Long

Parâmetros

i
Int32

O ordinal da coluna baseada em zero.

dataIndex
Int64

O índice dentro do campo a partir do qual iniciar a operação de leitura.

buffer
Byte[]

O buffer para ler o fluxo de bytes.

bufferIndex
Int32

O índice dentro do buffer local onde a operação de escrita deve começar.

length
Int32

O comprimento máximo para copiar para o buffer.

Devoluções

Int64

O número real de bytes lidos.

Implementações

GetBytes(Int32, Int64, Byte[], Int32, Int32)

Observações

GetBytes devolve o número de bytes disponíveis no campo. Na maioria das vezes, este é exatamente o comprimento do campo. No entanto, o número devolvido pode ser inferior ao comprimento verdadeiro do campo se GetBytes já tiver sido usado para obter bytes do campo. Isto pode acontecer, por exemplo, se o SqlDataReader estiver a ler uma grande estrutura de dados num buffer. Para mais informações, consulte a SequentialAccess definição para CommandBehavior.

Se passar um buffer que é null, GetBytes devolve o comprimento de todo o campo em bytes, não o tamanho restante baseado no parâmetro de offset do buffer.

Não são realizadas conversões; Portanto, os dados recuperados já devem ser um array de bytes.

Aplica-se a

Ver também