XmlReader.ReadElementContentAsStringAsync Метод

Определение

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

System.Xml

Сборки:

netstandard.dll, System.Xml.ReaderWriter.dll

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

XmlReaderAsync.cs

Асинхронно считывает текущий элемент и возвращает содержимое в виде String объекта.

public:
 virtual System::Threading::Tasks::Task<System::String ^> ^ ReadElementContentAsStringAsync();

public virtual System.Threading.Tasks.Task<string> ReadElementContentAsStringAsync();

abstract member ReadElementContentAsStringAsync : unit -> System.Threading.Tasks.Task<string>
override this.ReadElementContentAsStringAsync : unit -> System.Threading.Tasks.Task<string>

Public Overridable Function ReadElementContentAsStringAsync () As Task(Of String)

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

Task<String>

Содержимое элемента в виде String объекта.

Исключения

InvalidOperationException

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

Комментарии

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

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

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

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