Método DataReader.GetBytes

Artigo
10/26/2012

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

Namespace: Microsoft.VisualStudio.Data
Assembly: Microsoft.VisualStudio.Data (em Microsoft.VisualStudio.Data.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 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 inteiro 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 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 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

DataReader Classe

Namespace Microsoft.VisualStudio.Data

Partilhar via