IDataRecord.GetChars(Int32, Int64, Char[], Int32, Int32) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 -> int64Public Function GetChars (i As Integer, fieldoffset As Long, buffer As Char(), bufferoffset As Integer, length As Integer) As LongParâ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.
