XmlValidatingReader.ReadElementContentAsBinHex(Byte[], Int32, Int32) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 -> intPublic Overrides Function ReadElementContentAsBinHex (buffer As Byte(), index As Integer, count As Integer) As IntegerParâ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
O número de bytes gravados no buffer.
Exceções
O valor buffer é null.
O nó atual não é um nó de elemento.
O índice de buffer ou de índice + contagem é maior que o tamanho do buffer alocado.
A implementação XmlValidatingReader não dá suporte a esse método.
O elemento contém conteúdo misto.
Não é possível converter conteúdo no tipo solicitado.
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 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 pode ler apenas 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 que ele só pode ser chamado em tipos de nó de elemento.
Se o count valor for maior do que o número de bytes no documento ou se for igual ao número de bytes no documento, ele XmlValidatingReader lerá todos os bytes restantes no documento e retornará o número de bytes lidos. A próxima XmlValidatingReader chamada de método retorna um zero e move o leitor para o nó após o EndElement.
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 lerá todo o texto até que o elemento final seja encontrado. Em seguida, ele lerá o nó de marca final, lerá o próximo nó e, em seguida, posicionará-se no próximo nó subsequente.