Compartir a través de


XmlReader.ReadOuterXmlAsync Método

Definición

Lee de forma asincrónica el contenido, incluido el marcado, que representa este nodo y todos sus elementos secundarios.

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)

Devoluciones

Si el lector se coloca en un elemento o en un nodo de atributo, este método devuelve todo el contenido XML, incluido el marcado, del nodo actual y todos sus elementos secundarios; de lo contrario, devuelve una cadena vacía.

Excepciones

Se llamó a un XmlReader método asincrónico sin establecer la Async marca trueen . En este caso, InvalidOperationException se produce con el mensaje "Establecer XmlReaderSettings.Async en true si desea usar métodos asincrónicos".

Comentarios

Esta es la versión asincrónica de ReadOuterXml, con la misma funcionalidad. Para usar este método, debe establecer la Async marca trueen .

Este método almacena en la tarea que devuelve todas las excepciones de no uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por ReadOuterXml().

Se aplica a

Consulte también