SqlCeDataReader.GetChars Method

Artigo
01/14/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

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

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

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

Parâmetros

ordinal
O ordinal da coluna com base zero.

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

buffer
O buffer no qual os dados devem ser copiados.

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

length
O número de caracteres a serem lidos.

Valor de retorno

O número real de caracteres lidos.

Exceções

Tipo de 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, GetChars retornará o comprimento do campo, em caracteres.

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

Segurança de thread

Quaisquer membros estáticos públicos (compartilhados no Microsoft Visual Basic) desse tipo são thread safe. Não há garantia de que qualquer membro de instância seja thread safe.

Plataformas

Plataformas de desenvolvimento

Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
Informações de versão
.NET Framework e NET Compact Framework
Com suporte no 3.5
.NET Framework
Com suporte no 3.0
.NET Compact Framework e .Net Framework
Com suporte no 2.0

Consulte também

Referência

SqlCeDataReader Class
SqlCeDataReader Members
System.Data.SqlServerCe Namespace

Compartilhar via