Compartilhar via


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

Definição

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:
 virtual 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);
public long GetChars (int ordinal, long dataIndex, 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
abstract member GetChars : int * int64 * char[] * int * int -> int64
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
Public 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

O número real de caracteres lidos.

Implementações

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.

Aplica-se a

Confira também