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)