XmlReader.ReadContentAsStringAsync Метод

Определение

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

System.Xml

Сборки:

netstandard.dll, System.Xml.ReaderWriter.dll

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

XmlReaderAsync.cs

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

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

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

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

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

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

Task<String>

Текстовое String содержимое в виде объекта.

Исключения

InvalidOperationException

Метод XmlReader был вызван до завершения предыдущей асинхронной операции. В этом случае InvalidOperationException создается сообщение "Асинхронная операция уже выполняется".

–или–

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

Комментарии

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

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

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

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