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

Definição

Namespace:

System.Data

Assembly:

System.Data.Common.dll

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);

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

Int64

O número real de caracteres lidos.

Exceções

IndexOutOfRangeException

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.