XmlWriter.WriteNodeAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Асинхронно копирует все данные исходного объекта в текущий экземпляр средства записи.
Перегрузки
| WriteNodeAsync(XPathNavigator, Boolean) |
Асинхронно копирует все из объекта XPathNavigator в средство записи. Позиция XPathNavigator остается неизменной. |
| WriteNodeAsync(XmlReader, Boolean) |
Асинхронно копирует все данные из средства чтения в средство записи и перемещает средство чтения к началу следующего элемента того же уровня. |
Комментарии
Это асинхронная версия WriteNodeс теми же функциями. Чтобы использовать этот метод, необходимо задать для флага Async trueзначение .
WriteNodeAsync(XPathNavigator, Boolean)
Асинхронно копирует все из объекта XPathNavigator в средство записи. Позиция XPathNavigator остается неизменной.
public:
virtual System::Threading::Tasks::Task ^ WriteNodeAsync(System::Xml::XPath::XPathNavigator ^ navigator, bool defattr);
public virtual System.Threading.Tasks.Task WriteNodeAsync (System.Xml.XPath.XPathNavigator navigator, bool defattr);
abstract member WriteNodeAsync : System.Xml.XPath.XPathNavigator * bool -> System.Threading.Tasks.Task
override this.WriteNodeAsync : System.Xml.XPath.XPathNavigator * bool -> System.Threading.Tasks.Task
Public Overridable Function WriteNodeAsync (navigator As XPathNavigator, defattr As Boolean) As Task
Параметры
- navigator
- XPathNavigator
Элемент XPathNavigator, из которого копируются данные.
- defattr
- Boolean
Значение true — копирование атрибутов по умолчанию; в противном случае — false.
Возвращаемое значение
Задача, представляющая асинхронную операцию WriteNode.
Исключения
Метод XmlWriter вызван перед завершением предыдущей асинхронной операции. В этом случае возникает исключение InvalidOperationException с сообщением "Асинхронная операция уже выполняется".
-или-
Асинхронный метод XmlWriter вызван без присваивания флагу Async значения true. В этом случае вызывается исключение InvalidOperationException с сообщением "Задайте параметру XmlWriterSettings.Async значение true, если вы хотите использовать асинхронные методы".
Комментарии
Это асинхронная версия WriteNode, с той же функциональностью. Чтобы использовать этот метод, необходимо задать для флага Async trueзначение .
См. также раздел
- Асинхронное программирование (C#)
- Асинхронное программирование с помощью Async и Await (Visual Basic)
Применяется к
WriteNodeAsync(XmlReader, Boolean)
Асинхронно копирует все данные из средства чтения в средство записи и перемещает средство чтения к началу следующего элемента того же уровня.
public:
virtual System::Threading::Tasks::Task ^ WriteNodeAsync(System::Xml::XmlReader ^ reader, bool defattr);
public virtual System.Threading.Tasks.Task WriteNodeAsync (System.Xml.XmlReader reader, bool defattr);
abstract member WriteNodeAsync : System.Xml.XmlReader * bool -> System.Threading.Tasks.Task
override this.WriteNodeAsync : System.Xml.XmlReader * bool -> System.Threading.Tasks.Task
Public Overridable Function WriteNodeAsync (reader As XmlReader, defattr As Boolean) As Task
Параметры
- defattr
- Boolean
Значение true, чтобы скопировать атрибуты по умолчанию из XmlReader; в противном случае — значение false.
Возвращаемое значение
Задача, представляющая асинхронную операцию WriteNode.
Исключения
Метод XmlWriter вызван перед завершением предыдущей асинхронной операции. В этом случае возникает исключение InvalidOperationException с сообщением "Асинхронная операция уже выполняется".
-или-
Асинхронный метод XmlWriter вызван без присваивания флагу Async значения true. В этом случае вызывается исключение InvalidOperationException с сообщением "Задайте параметру XmlWriterSettings.Async значение true, если вы хотите использовать асинхронные методы".
Комментарии
Это асинхронная версия WriteNodeс теми же функциями. Чтобы использовать этот метод, необходимо задать для флага Async trueзначение .
См. также раздел
- Асинхронное программирование (C#)
- Асинхронное программирование с помощью Async и Await (Visual Basic)