Ler em inglês

Compartilhar via

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

  • Referência

Definição

Namespace:
System.Data
Assemblies:
netstandard.dll, System.Data.Common.dll
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.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, char[]? buffer, int bufferoffset, int length);
public long GetChars(int i, long fieldoffset, char[] buffer, int bufferoffset, int length);

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.

Aplica-se a

Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1