XmlReader.ReadElementContentAsObjectAsync Метод

Определение

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

System.Xml

Сборки:

netstandard.dll, System.Xml.ReaderWriter.dll

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

XmlReaderAsync.cs

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

public:
 virtual System::Threading::Tasks::Task<System::Object ^> ^ ReadElementContentAsObjectAsync();

public virtual System.Threading.Tasks.Task<object> ReadElementContentAsObjectAsync();

abstract member ReadElementContentAsObjectAsync : unit -> System.Threading.Tasks.Task<obj>
override this.ReadElementContentAsObjectAsync : unit -> System.Threading.Tasks.Task<obj>

Public Overridable Function ReadElementContentAsObjectAsync () As Task(Of Object)

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

Task<Object>

Объект стандартной среды CLR для наиболее подходящего типа. Свойство ValueType определяет соответствующий тип СРЕДЫ CLR. Если содержимое типируется как тип списка, этот метод возвращает массив прямоугольных объектов соответствующего типа.

Исключения

InvalidOperationException

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

–или–

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

Комментарии

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

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

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

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