XmlReader.ReadOuterXmlAsync Метод

Определение

Пространство имен:

System.Xml

Сборки:

netstandard.dll, System.Xml.ReaderWriter.dll

Исходный код:

XmlReader.cs

Асинхронно считывает содержимое, включая разметку, представляющую этот узел и все его дочерние элементы.

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)

Возвращаемое значение

Task<String>

Если средство чтения расположено на элементе или узле атрибута, этот метод возвращает все XML-содержимое, включая разметку текущего узла и всех его дочерних элементов; в противном случае возвращает пустую строку.

Исключения

InvalidOperationException

Асинхронный XmlReader метод был вызван без задания флага Asynctrue. В этом случае создается сообщение "Задать XmlReaderSettings.Async значение true, InvalidOperationException если вы хотите использовать Асинхронные методы".

Комментарии

Это асинхронная версия ReadOuterXmlс той же функциональностью. Чтобы использовать этот метод, необходимо задать для флага Asynctrueзначение .

Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых ReadOuterXml().

См. также раздел

• Асинхронное программирование (C#)
• Асинхронное программирование с помощью Async и Await (Visual Basic)