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

Definição

Espaço de Nomes:
System.Xml
Assemblagem:
System.Xml.dll
Assemblagem:
netstandard.dll

Lê o conteúdo e devolve os bytes binários decodificados em 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 onde copiar o texto resultante. Este valor não pode ser null.

index
Int32

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

count
Int32

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

Devoluções

Int32

O número de bytes escritos no buffer.

Exceções

ArgumentNullException

O buffer valor é null.

InvalidOperationException

ReadContentAsBinHex(Byte[], Int32, Int32) não é suportado no nó atual.

ArgumentOutOfRangeException

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

Observações

Note

Para tirar partido das funcionalidades mais recentes, a prática recomendada é criar XmlReader instâncias usando a XmlReaderSettings classe e o Create método. Para mais informações, consulte a secção de Observações na XmlReader página de referência.

Este método transmite o conteúdo, descodifica o conteúdo BinHex e devolve os bytes binários decodificados (por exemplo, uma imagem GIF codificada em linha BinHex) para o buffer. Este método pode ser chamado sucessivamente para ler grandes fluxos de texto embutido.

Note

Não deve aceder a nenhuma das propriedades do leitor entre chamadas ao ReadContentAsBinHex método até que este devolva o valor 0.

Este método apresenta o seguinte comportamento:

  • ReadContentAsBinHex devolve o valor 0 quando atinge o fim do fluxo de bytes em que estava a operar. O leitor posiciona-se no primeiro nó não-conteúdo.

  • Se pedir menos, ou o número exato, de bytes do que restam no fluxo, o leitor mantém-se na sua posição atual.

  • ReadContentAsBinHex não é suportado nos seguintes tipos de nós XML: Element, XmlDeclaration, Nenhum, Documento, DocumentType, Notation, Entity, DocumentFragment.

Aplica-se a

Ver também