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

Definição

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Origem:

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

NotSupportedException

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

Comentários

Observação

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 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 que são deixados 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 e DocumentFragment.

Confira também

• XmlReader
• ReadElementContentAsBinHex(Byte[], Int32, Int32)
• XmlNodeType