SqlCeResultSet.GetBytes Method

Artigo
01/14/2011

Copia um comprimento de bytes 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 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
A posição ordinal da coluna da qual os dados devem ser recuperados.

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

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 bytes copiados para o buffer.

Comentários

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

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

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

GetBytes pode ser chamado apenas para colunas com um tipo subjacente binário ou varbinary, ou que tenham sido construídas com objetos que podem ser convertidos em uma matriz de bytes.

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