Compartilhar via

OracleDataReader.GetChars(Int32, Int64, Char[], Int32, Int32) Método

  • Referência

Definição

Namespace:
System.Data.OracleClient
Assembly:
System.Data.OracleClient.dll

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 -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64
Public Function GetChars (i As Integer, fieldOffset As Long, buffer2 As Char(), bufferoffset As Integer, length As Integer) As Long
Public Overrides Function GetChars (i As Integer, fieldOffset As Long, buffer2 As Char(), bufferoffset As Integer, length As Integer) As Long

Parâ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

Int64

O número real de caracteres lidos.

Implementações

GetChars(Int32, Int64, Char[], Int32, Int32)

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.

Aplica-se a