XmlReader.ReadOuterXmlAsync 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ê 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
- Programação assíncrona (C#)
Assíncrona com Async e Await (Visual Basic)