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

Definição

Namespace:
System.Data.Odbc
Assembly:
System.Data.Odbc.dll
Assembly:
System.Data.dll
Pacote:
System.Data.Odbc v11.0.0-preview.4.26230.115
Origem:
OdbcDataReader.cs
Origem:
OdbcDataReader.cs
Origem:
OdbcDataReader.cs
Origem:
OdbcDataReader.cs

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

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

dataIndex
Int64

O índice dentro da linha em que a operação de leitura deve ser iniciada.

buffer
Char[]

O buffer no qual copiar dados.

bufferIndex
Int32

O índice no buffer local em que a operação de gravação deve ser iniciada.

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 das vezes, esse é o comprimento exato do campo. No entanto, o número retornado poderá ser menor que o comprimento verdadeiro do campo se GetChars já tiver sido usado para obter caracteres do campo. Esse pode ser o caso, por exemplo, se estiver OdbcDataReader lendo uma estrutura de dados grande em um buffer. Para obter mais informações, consulte a SequentialAccess configuração para CommandBehavior.

Se você passar um buffer que seja um valor nulo, GetChars retornará o comprimento do campo em caracteres.

As conversões são executadas com base nos recursos subjacentes do driver ODBC. Se não houver suporte para a conversão, a chamada do método falhará.

Note

Nenhuma exceção será gerada se o valor estiver bufferIndex fora da matriz. Nenhum dado será lido e o método retornará 0.

Aplica-se a

Confira também