XmlValidatingReader.ReadContentAsBinHex(Byte[], Int32, Int32) Método

Definição

Lê o conteúdo e retorna os bytes binários decodificados do BinHex.

public:
 override int ReadContentAsBinHex(cli::array <System::Byte> ^ buffer, int index, int count);
public override int ReadContentAsBinHex(byte[] buffer, int index, int count);
override this.ReadContentAsBinHex : byte[] * int * int -> int
Public Overrides Function ReadContentAsBinHex (buffer As Byte(), index As Integer, count As Integer) As Integer

Parâmetros

buffer
Byte[]

O buffer no qual copiar o texto resultante. Esse valor não pode ser null.

index
Int32

O deslocamento para o buffer em que começar a copiar o resultado.

count
Int32

O número máximo de bytes a serem copiados para o buffer. O número real de bytes copiados é retornado desse método.

Retornos

O número de bytes gravados no buffer.

Exceções

O buffer valor é null.

O índice no buffer ou índice + contagem é maior que o tamanho do buffer alocado.

A XmlValidatingReader implementação não dá suporte a esse método.

Comentários

Note

A XmlValidatingReader classe está obsoleta no .NET Framework 2.0. Você pode criar uma instância de validação XmlReader usando a XmlReaderSettings classe e o Create método. Para obter mais informações, consulte a seção de Comentários da página de referência XmlReader.

Esse método transmite o conteúdo, decodifica o conteúdo binHex e retorna os bytes binários decodificados (por exemplo, uma imagem GIF codificada no BinHex embutido) no buffer. Esse método pode ser chamado sucessivamente para ler grandes fluxos de texto inserido.

Note

Você não deve acessar nenhuma das propriedades de leitor entre chamadas ao método até que ReadContentAsBinHex o método retorne o valor 0.

Esse método tem o seguinte comportamento:

  • ReadContentAsBinHex retorna o valor 0 quando chegou ao final do fluxo de bytes em que estava operando. O leitor está posicionado no primeiro nó que não é de conteúdo.

  • Se você solicitar menos, ou o número exato, de bytes que são deixados no fluxo, o leitor permanecerá em sua posição atual.

  • ReadContentAsBinHex não há suporte para os seguintes tipos de nó XML: Element, XmlDeclaration, None, Document, DocumentType, Notation, Entity e DocumentFragment.

Aplica-se a

Confira também