XmlReader.ReadOuterXmlAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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().