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

Definição

Namespace:

System.Data.Odbc

Assembly:

System.Data.Odbc.dll

Pacote:

System.Data.Odbc v8.0.0

Origem:

OdbcDataReader.cs

Lê um fluxo de bytes do deslocamento de coluna especificado no buffer como uma matriz, iniciando no deslocamento de buffer em particular.

public:
 override long GetBytes(int i, long dataIndex, cli::array <System::Byte> ^ buffer, int bufferIndex, int length);

public override long GetBytes (int i, long dataIndex, byte[]? buffer, int bufferIndex, int length);

override this.GetBytes : int * int64 * byte[] * int * int -> int64

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 baseado em zero.

dataIndex

Int64

O índice no campo em que a operação de leitura deve começar.

buffer

Byte[]

O buffer no qual o fluxo de bytes deve ser lido.

bufferIndex

Int32

O índice dentro de buffer no qual a operação de gravação deve ser iniciada.

length

Int32

O número de bytes a serem lidos.

Retornos

Int64

O número real de bytes lidos.

Comentários

GetBytes retorna o número de bytes disponíveis no campo. Na maioria das vezes, 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. Esse pode ser o caso, por exemplo, se o OdbcDataReader estiver lendo uma estrutura de dados grande em um buffer. Para obter mais informações, consulte a SequentialAccess configuração para CommandBehavior.

Se você passar um buffer que seja um valor nulo, GetBytes retornará o comprimento do campo em bytes.

As conversões são executadas com base nos recursos subjacentes do driver ODBC. Se não houver suporte para a conversão, a chamada de método falhará.

Observação

Nenhuma exceção será gerada se o valor de bufferIndex estiver fora da matriz. Nenhum dado será lido e o método retornará 0.

Confira também

• DataAdapters e DataReaders