XmlTextReader.ReadElementContentAsBase64(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 conteúdo do Base64.
public:
override int ReadElementContentAsBase64(cli::array <System::Byte> ^ buffer, int index, int count);public override int ReadElementContentAsBase64(byte[] buffer, int index, int count);override this.ReadElementContentAsBase64 : byte[] * int * int -> intPublic Overrides Function ReadElementContentAsBase64 (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 XmlTextReader 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.ReadElementContentAsBase64 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 dos elementos, descodifica-o usando codificação Base64 e devolve os bytes binários decodificados (por exemplo, uma imagem GIF codificada em Base64 em linha) para o buffer. Para mais informações, consulte o RFC 1521, "MIME (Multipurpose Internet Mail Extensions) Parte Um: Mecanismos para Especificar e Descrever o Formato dos Corpos de Mensagens na Internet". Pode obter RFCs no site de Pedido de Comentários.
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 ReadContentAsBase64 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.
