Método SqlCeDataReader.GetChars

Artigo
05/27/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
<SecurityTreatAsSafeAttribute> _
<SecurityCriticalAttribute> _
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)

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

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

[<SecurityTreatAsSafeAttribute>]
[<SecurityCriticalAttribute>]
abstract GetChars : 
        ordinal:int * 
        dataIndex:int64 * 
        buffer:char[] * 
        bufferIndex:int * 
        length:int -> int64 
[<SecurityTreatAsSafeAttribute>]
[<SecurityCriticalAttribute>]
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 de 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 iniciar 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 depois da ú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 nulluma referência nula (Nothing no Visual Basic), GetChars retornará o comprimento do campo, em caracteres.

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

Consulte também

Referência

SqlCeDataReader Classe

Namespace System.Data.SqlServerCe

Partilhar via