XmlReader.ReadAsync Метод

Определение

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

System.Xml

Сборки:

netstandard.dll, System.Xml.ReaderWriter.dll

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

XmlReaderAsync.cs

Асинхронно считывает следующий узел из потока.

public:
 virtual System::Threading::Tasks::Task<bool> ^ ReadAsync();

public virtual System.Threading.Tasks.Task<bool> ReadAsync();

abstract member ReadAsync : unit -> System.Threading.Tasks.Task<bool>
override this.ReadAsync : unit -> System.Threading.Tasks.Task<bool>

Public Overridable Function ReadAsync () As Task(Of Boolean)

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

Task<Boolean>

true Значение , если следующий узел успешно считывался; false Если для чтения больше узлов нет.

Исключения

InvalidOperationException

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

–или–

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

Комментарии

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

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

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

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