OracleDataReader.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:
virtual long GetChars(int i, long fieldOffset, cli::array <char> ^ buffer2, int bufferoffset, int length);public:
override long GetChars(int i, long fieldOffset, cli::array <char> ^ buffer2, int bufferoffset, int length);public long GetChars (int i, long fieldOffset, char[] buffer2, int bufferoffset, int length);public override long GetChars (int i, long fieldOffset, char[] buffer2, int bufferoffset, 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 (i As Integer, fieldOffset As Long, buffer2 As Char(), bufferoffset As Integer, length As Integer) As LongPublic Overrides Function GetChars (i As Integer, fieldOffset As Long, buffer2 As Char(), bufferoffset As Integer, length As Integer) As LongParâmetros
- i
- Int32
O ordinal da coluna baseado em zero.
- fieldOffset
- Int64
O índice na linha em que a operação de leitura deve ser iniciada.
- buffer2
- Char[]
O buffer para o qual copiar os dados.
- bufferoffset
- Int32
O índice no qual buffer2 deve iniciar a operação de gravação.
- length
- Int32
O número de caracteres a serem lidos.
Retornos
O número real de caracteres lidos.
Implementações
Comentários
GetChars retorna o número de caracteres disponíveis no campo. Na maioria dos casos, esse é o comprimento exato do campo. No entanto, o número retornado pode ser menor que o comprimento real do campo se GetChars já tiver sido usado para obter caracteres do campo. Esse pode ser o caso, por exemplo, se o OracleDataReader estiver lendo uma estrutura de dados grande em um buffer. Para obter mais informações, consulte a SequentialAccess configuração de CommandBehavior.
Se você passar um buffer que seja um valor nulo. GetChars retorna o comprimento do campo em caracteres.
