SqlCeDataReader.GetBytes Method

Artigo
01/14/2011

Lê um fluxo de bytes 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 GetBytes ( _
    ordinal As Integer, _
    dataIndex As Long, _
    buffer As Byte(), _
    bufferIndex As Integer, _
    length As Integer _
) As Long

public override long GetBytes (
    int ordinal,
    long dataIndex,
    byte[] buffer,
    int bufferIndex,
    int length
)

public:
virtual long long GetBytes (
    int ordinal, 
    long long dataIndex, 
    array<unsigned char>^ buffer, 
    int bufferIndex, 
    int length
) override

public long GetBytes (
    int ordinal, 
    long dataIndex, 
    byte[] buffer, 
    int bufferIndex, 
    int length
)

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

Parâmetros

ordinal
O ordinal da coluna com base zero.

dataIndex
O índice no campo do qual a operação de leitura deve iniciar.

buffer
O buffer no qual os fluxos de bytes devem ser lidos.

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

length
O comprimento máximo a ser copiado no buffer.

Valor de retorno

O número real de bytes 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

GetBytes retorna o número de bytes 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 GetBytes já tiver sido usado para obter bytes 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, GetBytes retornará o comprimento do campo, em bytes.

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

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

Partilhar via