OleDbDataReader.GetChars(Int32, Int64, Char[], Int32, Int32) Método

Definição

Namespace:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Pacote:

System.Data.OleDb v8.0.0

Origem:

OleDbDataReader.cs

Lê um fluxo de caracteres do deslocamento de coluna especificado no buffer como uma matriz, que inicia no deslocamento de buffer fornecido.

public:
 override long GetChars(int ordinal, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);

public override long GetChars (int ordinal, long dataIndex, char[]? buffer, int bufferIndex, int length);

override this.GetChars : int * int64 * char[] * int * int -> int64

Public Overrides Function GetChars (ordinal As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long

Parâmetros

ordinal

Int32

O ordinal da coluna baseado em zero.

dataIndex

Int64

O índice dentro da linha da qual iniciar a operação de leitura.

buffer

Char[]

O buffer para o qual copiar os dados.

bufferIndex

Int32

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

length

Int32

O número de caracteres a serem lidos.

Retornos

Int64

O número real de caracteres lidos.

Comentários

GetChars retorna o número de caracteres disponíveis no campo. Na maioria das vezes, esse é o comprimento exato do campo. No entanto, o número retornado pode ser menor que o comprimento real do campo se GetChars já tiver sido usado para obter caracteres do campo. Esse pode ser o caso, por exemplo, quando o OleDbDataReader está 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 null, GetChars retornará o comprimento do campo em caracteres.

Nenhuma conversão é executada; portanto, os dados recuperados já devem ser uma matriz de caracteres.

Confira também

• DataAdapters e DataReaders