Partilhar via


IDataRecord.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 iniciada no deslocamento de buffer fornecido.

public:
 long GetChars(int i, long fieldoffset, cli::array <char> ^ buffer, int bufferoffset, int length);
public long GetChars (int i, long fieldoffset, char[] buffer, int bufferoffset, int length);
public long GetChars (int i, long fieldoffset, char[]? buffer, int bufferoffset, int length);
abstract member GetChars : int * int64 * char[] * int * int -> int64
Public Function GetChars (i As Integer, fieldoffset As Long, buffer As Char(), bufferoffset As Integer, length As Integer) As Long

Parâmetros

i
Int32

O ordinal da coluna baseado em zero.

fieldoffset
Int64

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

buffer
Char[]

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

bufferoffset
Int32

O índice para o buffer para iniciar a operação de leitura.

length
Int32

O número de bytes a serem lidos.

Retornos

O número real de caracteres lidos.

Exceções

O índice passado estava fora do intervalo de 0 a FieldCount.

Comentários

GetChars retorna o número de caracteres disponíveis no campo. Frequentemente, esse é o comprimento exato do campo. No entanto, o número retornado poderá ser menor que o comprimento exato do campo se GetChars já tiver sido usado para obter caracteres do campo.

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