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

Definição

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

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

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 onde a operação de leitura deve começar.

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 número de bytes para ler.

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 OdbcDataReader 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 é um valor nulo, devolve GetBytes o comprimento do campo em bytes.

As conversões são realizadas com base nas capacidades subjacentes do driver ODBC. Se a conversão não for suportada, a chamada ao método falhará.

Note

Não será feita exceção se o valor de bufferIndex estiver fora do array. Nenhum dado será lido e o método devolverá 0.

Aplica-se a

Ver também