Partilhar via


XmlReader.ReadOuterXmlAsync Método

Definição

Lê o conteúdo de forma assíncrona, incluindo marcação, representando esse 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)

Retornos

Se o leitor estiver posicionado em um elemento ou um nó de atributo, esse método retornará todo o conteúdo XML, incluindo marcação, do nó atual e de todos os seus filhos; caso contrário, ele retorna uma cadeia de caracteres vazia.

Exceções

Um XmlReader método assíncrono foi chamado sem definir o Async sinalizador como true. Nesse caso, InvalidOperationException é gerada com a mensagem "Definir XmlReaderSettings.Async como true se você quiser usar métodos assíncronos".

Comentários

Essa é a versão assíncrona de ReadOuterXml, com a mesma funcionalidade. Para usar esse método, você deve definir o Async sinalizador como true.

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por ReadOuterXml().

Aplica-se a

Confira também