Método GetChars

Artigo
01/17/2011

Lê um fluxo de caracteres do deslocamento de coluna especificado no buffer como uma matriz que inicia no deslocamento de buffer fornecido.

Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (em System.Data.SqlServerCe.dll)

Sintaxe

'Declaração
Public Overrides Function GetChars ( _
    ordinal As Integer, _
    dataIndex As Long, _
    buffer As Char(), _
    bufferIndex As Integer, _
    length As Integer _
) As Long
'Uso
Dim instance As SqlCeDataReader
Dim ordinal As Integer
Dim dataIndex As Long
Dim buffer As Char()
Dim bufferIndex As Integer
Dim length As Integer
Dim returnValue As Long

returnValue = instance.GetChars(ordinal, _
    dataIndex, buffer, bufferIndex, length)

public override long GetChars(
    int ordinal,
    long dataIndex,
    char[] buffer,
    int bufferIndex,
    int length
)

public:
virtual long long GetChars(
    int ordinal, 
    long long dataIndex, 
    array<wchar_t>^ buffer, 
    int bufferIndex, 
    int length
) override

abstract GetChars : 
        ordinal:int * 
        dataIndex:int64 * 
        buffer:char[] * 
        bufferIndex:int * 
        length:int -> int64 
override GetChars : 
        ordinal:int * 
        dataIndex:int64 * 
        buffer:char[] * 
        bufferIndex:int * 
        length:int -> int64

public override function GetChars(
    ordinal : int, 
    dataIndex : long, 
    buffer : char[], 
    bufferIndex : int, 
    length : int
) : long

Parâmetros

ordinal
Tipo: System. . :: . .Int32
O ordinal da coluna com base zero.

dataIndex
Tipo: System. . :: . .Int64
O índice na linha da qual a operação de leitura deve iniciar.

buffer
Tipo: array<System. . :: . .Char> [] () [] []
O buffer no qual os dados devem ser copiados.

bufferIndex
Tipo: System. . :: . .Int32
O índice para o buffer começar a operação de leitura.

length
Tipo: System. . :: . .Int32
O número de caracteres a serem lidos.

Valor de retorno

Tipo: System. . :: . .Int64
O número real de caracteres lidos.

Implementa

IDataRecord. . :: . .GetChars(Int32, Int64, array<Char> [] () [] [], Int32, Int32)

Exceções

Exceção	Condição
InvalidOperationException	A operação não é válida. O SqlCeDataReader pode ser posicionado após a última linha no conjunto de resultados.

Comentários

GetChars retorna o número de caracteres disponíveis no campo. Na maioria dos casos, esse é o comprimento exato do campo. Entretanto, o número retornado poderá ser menor que o comprimento real do campo, se GetChars já tiver sido usado para obter caracteres do campo. Isso pode acontecer, por exemplo, quando o SqlCeDataReader estiver lendo uma grande estrutura de dados em um buffer. Para obter mais informações, consulte a configuração SequentialAccess para CommandBehavior.

Se você passar um buffer null Nothing nullptr unit uma referência nula (Nothing no Visual Basic) , GetChars retornará o comprimento do campo, em caracteres.

Nenhuma conversão é executada; assim, os dados recuperados já devem ser uma matriz de caracteres.