XmlTextReader.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

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.

NotSupportedException

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

Comentários

Observação

A partir do .NET Framework 2.0, recomendamos que você crie XmlReader instâncias usando o XmlReader.Create método para aproveitar a nova funcionalidade.

Esse método transmite o conteúdo, decodifica o BinHex conteúdo e retorna os bytes binários decodificados (por exemplo, uma imagem GIF codificada embutida BinHex ) 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 do leitor entre as chamadas para o ReadContentAsBinHex método até que o método retorne o valor 0.

Esse método tem o seguinte comportamento:

  • ReadContentAsBinHex retorna o valor 0 quando ele chegou ao final do fluxo de bytes em que estava operando. O leitor está posicionado no primeiro nó sem 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, . DocumentFragment.

Aplica-se a

Confira também