OleDbDataReader.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 a partir do deslocamento do buffer dado.
public:
virtual long GetChars(int ordinal, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);public:
override long GetChars(int ordinal, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);public long GetChars(int ordinal, long dataIndex, char[] buffer, int bufferIndex, int length);public override long GetChars(int ordinal, long dataIndex, char[] buffer, int bufferIndex, int length);abstract member GetChars : int * int64 * char[] * int * int -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64override this.GetChars : int * int64 * char[] * int * int -> int64Public Function GetChars (ordinal As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As LongPublic Overrides Function GetChars (ordinal As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As LongParâmetros
- ordinal
- Int32
O ordinal da coluna baseada em zero.
- dataIndex
- Int64
O índice dentro da linha a partir do qual iniciar a operação de leitura.
- buffer
- Char[]
O buffer para onde copiar os dados.
- bufferIndex
- Int32
O índice dentro do buffer local onde a operação de escrita deve começar.
- length
- Int32
O número de caracteres para ler.
Devoluções
O número real de caracteres lidos.
Implementações
Observações
GetChars devolve o número de caracteres disponíveis no campo. Na maioria das vezes, este é exatamente o comprimento do campo. No entanto, o número devolvido pode ser inferior ao comprimento real do campo se GetChars já tiver sido usado para obter caracteres do campo. Isto pode acontecer, por exemplo, quando está OleDbDataReader a ler uma grande estrutura de dados num buffer. Para mais informações, consulte a SequentialAccess definição para CommandBehavior.
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.