SqlCeResultSet.GetChars Method

Artigo
01/14/2011

Copia um comprimento de caracteres no buffer, iniciando em uma posição especificada no campo especificado.

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
A posição ordinal do campo do qual os dados devem ser recuperados.

dataIndex
O deslocamento (em caracteres) no campo do qual deve ser iniciada a cópia.

buffer
O buffer no qual os dados devem ser copiados.

bufferIndex
No buffer, o deslocamento a partir do qual a cópia deve ser iniciada.

length
O número máximo de bytes a serem copiados.

Valor de retorno

O número real de caracteres copiados.

Comentários

Esta função retorna o número real de caracteres copiados, que poderá ser menor que o comprimento solicitado se o final do campo for atingido.

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

Se o comando for executado com um comportamento de comando de SequentialAccess, as chamadas para GetChars devem especificar leituras que aumentam seqüencialmente; caso contrário, será lançada uma exceção.

Uma exceção será lançada se não existir nenhum campo na posição ordinal especificada.

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

SqlCeResultSet Class
SqlCeResultSet Members
System.Data.SqlServerCe Namespace

Compartilhar via