Compartilhar via


Método DataReader.GetBytes (String, 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 Overridable Function GetBytes ( _
    name As String, _
    buffer As Byte(), _
    bufferIndex As Integer, _
    length As Integer _
) As Integer
public virtual int GetBytes(
    string name,
    byte[] buffer,
    int bufferIndex,
    int length
)
public:
virtual int GetBytes(
    String^ name, 
    array<unsigned char>^ buffer, 
    int bufferIndex, 
    int length
)
abstract GetBytes : 
        name:string * 
        buffer:byte[] * 
        bufferIndex:int * 
        length:int -> int 
override GetBytes : 
        name:string * 
        buffer:byte[] * 
        bufferIndex:int * 
        length:int -> int 
public function GetBytes(
    name : String, 
    buffer : byte[], 
    bufferIndex : int, 
    length : int
) : int

Parâmetros

  • name
    Tipo: System.String
    O nome do item que que recupera dados binários crua.
  • 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(String, array<Byte[], Int32, Int32)

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.

Este método chama GetItemIndex para obter o índice correspondente ao nome do item e então passa esse índice para GetBytes para recuperar o número de bytes aplicativo de dados binários crua.

Segurança do .NET Framework

Consulte também

Referência

DataReader Classe

Sobrecargas GetBytes

Namespace Microsoft.VisualStudio.Data.Framework

GetBytes