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 para o buffer como uma matriz, começando 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 -> 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 de 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 ler o fluxo de bytes.
- bufferoffset
- Int32
O índice para buffer 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 do 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.