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

Definição

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Origem:

XmlNodeReader.cs

Lê o elemento e decodifica o conteúdo BinHex.

public:
 override int ReadElementContentAsBinHex(cli::array <System::Byte> ^ buffer, int index, int count);

public override int ReadElementContentAsBinHex (byte[] buffer, int index, int count);

override this.ReadElementContentAsBinHex : byte[] * int * int -> int

Public Overrides Function ReadElementContentAsBinHex (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

O nó atual não é um nó de elemento.

ArgumentOutOfRangeException

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

XmlException

O elemento contém conteúdo misto.

FormatException

Não é possível converter conteúdo no tipo solicitado.

Exemplos

Consulte XmlReader.ReadElementContentAsBinHex para ver um exemplo usando esse método.

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 lê o conteúdo do elemento, o decodifica usando a codificação BinHex e retorna os bytes binários decodificados (por exemplo, uma imagem GIF codificada em BinHex embutida) no buffer.

Esse método só pode ler elementos de conteúdo simples. O elemento pode conter texto, espaço em branco, espaço em branco significativo, seções CDATA, comentários e instruções de processamento. Ele também pode conter referências de entidade, que são expandidas automaticamente. O elemento não pode ter elementos filho.

Esse método é muito semelhante ao ReadContentAsBinHex método, exceto pelo fato de que ele só pode ser chamado em tipos de nó de elemento.

Se o valor de contagem for maior que o número de bytes no documento ou se for igual ao número de bytes no documento, o XmlNodeReader lerá todos os bytes restantes no documento e retornará o número de bytes lidos. A próxima XmlNodeReader chamada de método retorna um zero e move o leitor para o nó após o EndElement nó.

Se você chamar Read antes que todo o conteúdo do elemento seja consumido, o leitor poderá se comportar como se o primeiro conteúdo fosse consumido e, em seguida, o Read método fosse chamado. Isso significa que o leitor lê todo o texto até que o elemento final seja encontrado. Em seguida, ele lê o nó de marca final, lê o próximo nó e, em seguida, posiciona-se no próximo nó subsequente.

Confira também

• ReadContentAsBinHex(Byte[], Int32, Int32)
• ReadElementContentAsBase64(Byte[], Int32, Int32)