IDataRecord.GetChars(Int32, Int64, Char[], Int32, Int32) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Lê um fluxo de caracteres do deslocamento de coluna especificado para o buffer como um array, começando no deslocamento do buffer dado.
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 baseada em zero.
- fieldoffset
- Int64
O índice dentro da linha a partir do qual iniciar a operação de leitura.
- buffer
- Char[]
O buffer para ler o fluxo de bytes.
- bufferoffset
- Int32
O índice para buffer iniciar a operação de leitura.
- length
- Int32
O número de bytes para ler.
Devoluções
O número real de caracteres lidos.
Exceções
O índice aprovado estava fora do intervalo de 0 até FieldCount.
Observações
GetChars devolve o número de caracteres disponíveis no campo. Frequentemente, este é o comprimento exato do campo. No entanto, o número devolvido pode ser inferior ao comprimento exato do campo se GetChars já tiver sido usado para obter caracteres do campo.
Se passar um buffer que é null, GetChars devolve o comprimento do campo em caracteres.
Não são realizadas conversões; portanto, os dados recuperados já devem ser um array de caracteres.
