XmlTextReader.ReadElementContentAsBinHex(Byte[], Int32, Int32) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Lê o elemento e decodifica o BinHex conteúdo.
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 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
O número de bytes escritos no buffer.
Exceções
O buffer valor é null.
O nó atual não é um nó elemento.
O índice no buffer ou índice + contagem é maior do que o tamanho do buffer alocado.
A XmlReader implementação não suporta este método.
O elemento contém conteúdo misto.
O conteúdo não pode ser convertido para o tipo solicitado.
Exemplos
Veja XmlReader.ReadElementContentAsBinHex para ver um exemplo usando este método.
Observações
Note
Recomendamos que crie instâncias XmlReader usando o método XmlReader.Create para aproveitar a nova funcionalidade.
Este método lê o conteúdo do elemento, descodifica-o usando BinHex codificação e devolve os bytes binários decodificados (por exemplo, uma imagem GIF codificada BinHex em linha) para o buffer.
Este método só pode ler elementos de conteúdo simples. O elemento pode conter texto, espaços em branco, espaços em branco significativos, secções CDATA, comentários e instruções de processamento. Também pode conter referências de entidades, que são automaticamente expandidas. O elemento não pode ter elementos filhos.
Este método é muito semelhante ao ReadContentAsBinHex método, exceto que só pode ser chamado em tipos de nós elemento.
Se o count valor for superior ao número de bytes no documento, ou se for igual ao número de bytes no documento, lê XmlTextReader todos os bytes restantes no documento e devolve o número de bytes lidos. A próxima XmlTextReader chamada ao método devolve um zero e move o leitor para o nó que segue o EndElement.
Se chamar Read antes de todo o conteúdo elemental ser consumido, o leitor pode comportar-se como se o primeiro conteúdo tivesse sido consumido e depois o Read método tivesse sido chamado. Isto significa que o leitor lê todo o texto até encontrar o elemento final. Depois, lê o nó da etiqueta final, lê o nó seguinte e posiciona-se no nó seguinte.
