Compartilhar via


Método DataReader.GetBytes (Int32, array<Byte , Int32, Int32)

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

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

Sintaxe

'Declaração
Public MustOverride Function GetBytes ( _
    index As Integer, _
    buffer As Byte(), _
    bufferIndex As Integer, _
    length As Integer _
) As Integer
public abstract int GetBytes(
    int index,
    byte[] buffer,
    int bufferIndex,
    int length
)
public:
virtual int GetBytes(
    int index, 
    array<unsigned char>^ buffer, 
    int bufferIndex, 
    int length
) abstract
abstract GetBytes : 
        index:int * 
        buffer:byte[] * 
        bufferIndex:int * 
        length:int -> int 
public abstract 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 uma 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
    O índice do ponto de partida na matriz de bytes especificado no parâmetro de buffer .
  • length
    Tipo: System.Int32
    O número de bytes a ser lido na matriz de bytes especificado no parâmetro de buffer .

Valor de retorno

Tipo: System.Int32
Um valor inteiro indicando o número de bytes no buffer.

Implementações

IVsDataReader.GetBytes(Int32, array<Byte[], Int32, Int32)

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 DDEX na forma de bytes crua, chamar esse método para somente leitura um número de bytes especificado em um buffer do lado do cliente existente.Isso proporciona um desempenho melhor do que simplesmente recuperar o valor inteiro, que faz com que todos os dados a serem lidos e atribuída na memória.

Observações para herdeiros

A classe derivada deve substituir esse método.

Segurança do .NET Framework

Consulte também

Referência

DataReader Classe

Sobrecargas GetBytes

Namespace Microsoft.VisualStudio.Data.Framework

GetBytes