Método AdoDotNetDataReader.GetBytes

Artigo
10/26/2012

Recupera um número de bytes especificado de dados binários.

Namespace: Microsoft.VisualStudio.Data.AdoDotNet
Assembly: Microsoft.VisualStudio.Data (em Microsoft.VisualStudio.Data.dll)

Sintaxe

'Declaração
Public Overrides Function GetBytes ( _
    index As Integer, _
    buffer As Byte(), _
    bufferIndex As Integer, _
    length As Integer _
) As Integer

public override int GetBytes(
    int index,
    byte[] buffer,
    int bufferIndex,
    int length
)

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

abstract GetBytes : 
        index:int * 
        buffer:byte[] * 
        bufferIndex:int * 
        length:int -> int 
override GetBytes : 
        index:int * 
        buffer:byte[] * 
        bufferIndex:int * 
        length:int -> int

public override function GetBytes(
    index : int, 
    buffer : byte[], 
    bufferIndex : int, 
    length : int
) : int

Parâmetros

index
Tipo: System.Int32
Índice no bloco atual de dados que recupera o item.

buffer
Tipo: array<System.Byte[]
Uma matriz em que especificou dados, como um matriz de bytes, deve ser colocada.Se nulluma referência nula (Nothing no Visual Basic), esse método retorna o tamanho da matriz necessário para caber todos os dados especificados.

bufferIndex
Tipo: System.Int32
Índice do ponto de partida na matriz de bytes especificado pelo parâmetro de buffer .

length
Tipo: System.Int32
O número de bytes a ser lido na matriz de bytes especificado pelo parâmetro de buffer .

Valor de retorno

Tipo: System.Int32
Retorna um valor numérico indicando o número de bytes no buffer.

Exceções

Exceção	Condição
ArgumentOutOfRangeException	index, bufferIndex, e/ou os parâmetros de length são inválidos.

Comentários

Quando dados são apresentados pelo provedor de dados na forma de bytes, esse método pode ser chamado somente para ler um determinado número de bytes em um buffer existente do lado do cliente.Isso executa melhor do que simplesmente recuperar o valor inteiro, que faz com que todos os dados a serem lidos e atribuída na memória.

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

AdoDotNetDataReader Classe

Namespace Microsoft.VisualStudio.Data.AdoDotNet

Partilhar via