Compartilhar via

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

  • Referência

Definição

Namespace:
System.Xml
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll
Origem:
XmlNodeReader.cs
Origem:
XmlNodeReader.cs
Origem:
XmlNodeReader.cs

Lê o conteúdo e retorna os bytes binários decodificados 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 para o qual o texto resultante será copiado. Este valor pode não ser null.

index
Int32

O deslocamento do buffer no qual o resultado começará a ser copiado.

count
Int32

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

Retornos

Int32

O número de bytes gravados no buffer.

Exceções

ArgumentNullException

O valor buffer é null.

InvalidOperationException

Não há suporte para ReadContentAsBinHex(Byte[], Int32, Int32) no nó atual.

ArgumentOutOfRangeException

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

Comentários

Observação

No .NET Framework 2.0, a prática recomendada é criar XmlReader instâncias usando a XmlReaderSettings classe e o Create método . Isso permite que você aproveite ao máximo todos os novos recursos introduzidos no .NET Framework. Para obter mais informações, consulte a seção Comentários na XmlReader página de referência.

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 em BinHex embutida) no buffer. Esse método pode ser chamado sucessivamente para ler grandes fluxos de texto inserido.

Observação

Você não deve acessar nenhuma das propriedades de leitor entre chamadas para o 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 ele atingiu o final do fluxo de bytes em que estava operando. O leitor é posicionado no primeiro nó que não é de conteúdo.

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

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

Aplica-se a

Confira também