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

Definição

Espaço de Nomes:
System.Data.Odbc
Assemblagem:
System.Data.dll

Lê um fluxo de caracteres do deslocamento de coluna especificado para o buffer como um array, começando no deslocamento específico do buffer.

public:
 virtual long GetChars(int i, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);
public:
 override long GetChars(int i, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);
public long GetChars(int i, long dataIndex, char[] buffer, int bufferIndex, int length);
public override long GetChars(int i, 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 -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64
Public Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long
Public Overrides Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long

Parâmetros

i
Int32

O ordinal da coluna baseada em zero.

dataIndex
Int64

O índice dentro da linha onde a operação de leitura deve começar.

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

Int64

O número real de caracteres lidos.

Implementações

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

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, se o OdbcDataReader estiver a ler uma grande estrutura de dados num buffer. Para mais informações, consulte a SequentialAccess definição para CommandBehavior.

Se passares um buffer que é um valor nulo, GetChars devolve o comprimento do campo em caracteres.

As conversões são realizadas com base nas capacidades subjacentes do driver ODBC. Se a conversão não for suportada, a chamada ao método falhará.

Note

Não será feita exceção se o valor de bufferIndex estiver fora do array. Nenhum dado será lido e o método devolverá 0.

Aplica-se a

Ver também