XmlReader.ReadOuterXmlAsync Método

Definição

Lê assíncronamente o conteúdo, incluindo a marcação, que representa este nó e todos os seus filhos.

public:
 virtual System::Threading::Tasks::Task<System::String ^> ^ ReadOuterXmlAsync();
public virtual System.Threading.Tasks.Task<string> ReadOuterXmlAsync();
abstract member ReadOuterXmlAsync : unit -> System.Threading.Tasks.Task<string>
override this.ReadOuterXmlAsync : unit -> System.Threading.Tasks.Task<string>
Public Overridable Function ReadOuterXmlAsync () As Task(Of String)

Devoluções

Se o leitor estiver posicionado num elemento ou num nó de atributo, este método devolve todo o conteúdo XML, incluindo a marcação, do nó atual e de todos os seus filhos; caso contrário, devolve uma cadeia vazia.

Exceções

Um XmlReader método assíncrono era chamado sem definir a Async flag para true. Neste caso, InvalidOperationException aparece com a mensagem "Set XmlReaderSettings.Async to true se quiseres usar Métodos Assíncronos."

Observações

Esta é a versão assíncrona de ReadOuterXml, com a mesma funcionalidade. Para usar este método, deve definir o Async flag para true.

Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por ReadOuterXml().

Aplica-se a

Ver também