XmlWriter.WriteStartDocumentAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Асинхронно записывает объявление XML.
Перегрузки
| Имя | Описание |
|---|---|
| WriteStartDocumentAsync() |
Асинхронно записывает xml-объявление с версией 1.0. |
| WriteStartDocumentAsync(Boolean) |
Асинхронно записывает объявление XML с версией "1.0" и автономным атрибутом. |
Комментарии
Это асинхронная версия WriteStartDocumentс той же функциональностью. Чтобы использовать этот метод, необходимо задать для флага Asynctrueзначение .
WriteStartDocumentAsync()
- Исходный код:
- XmlWriterAsync.cs
- Исходный код:
- XmlWriterAsync.cs
- Исходный код:
- XmlWriterAsync.cs
- Исходный код:
- XmlWriterAsync.cs
- Исходный код:
- XmlWriterAsync.cs
Асинхронно записывает xml-объявление с версией 1.0.
public:
virtual System::Threading::Tasks::Task ^ WriteStartDocumentAsync();public virtual System.Threading.Tasks.Task WriteStartDocumentAsync();abstract member WriteStartDocumentAsync : unit -> System.Threading.Tasks.Task
override this.WriteStartDocumentAsync : unit -> System.Threading.Tasks.TaskPublic Overridable Function WriteStartDocumentAsync () As TaskВозвращаемое значение
Задача, представляющая асинхронную WriteStartDocument операцию.
Исключения
Метод XmlWriter был вызван до завершения предыдущей асинхронной операции. В этом случае InvalidOperationException создается сообщение "Асинхронная операция уже выполняется".
–или–
Асинхронный XmlWriter метод был вызван без задания флага Asynctrue. В этом случае InvalidOperationException создается сообщение "Set XmlWriterSettings.Async to true, если вы хотите использовать Асинхронные методы".
Комментарии
Это асинхронная версия WriteStartDocumentс той же функциональностью. Чтобы использовать этот метод, необходимо задать для флага Asynctrueзначение .
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых WriteStartDocument().
См. также раздел
- Асинхронное программирование (C#)
- Асинхронное программирование с помощью Async и Await (Visual Basic)
Применяется к
WriteStartDocumentAsync(Boolean)
- Исходный код:
- XmlWriterAsync.cs
- Исходный код:
- XmlWriterAsync.cs
- Исходный код:
- XmlWriterAsync.cs
- Исходный код:
- XmlWriterAsync.cs
- Исходный код:
- XmlWriterAsync.cs
Асинхронно записывает объявление XML с версией "1.0" и автономным атрибутом.
public:
virtual System::Threading::Tasks::Task ^ WriteStartDocumentAsync(bool standalone);public virtual System.Threading.Tasks.Task WriteStartDocumentAsync(bool standalone);abstract member WriteStartDocumentAsync : bool -> System.Threading.Tasks.Task
override this.WriteStartDocumentAsync : bool -> System.Threading.Tasks.TaskPublic Overridable Function WriteStartDocumentAsync (standalone As Boolean) As TaskПараметры
- standalone
- Boolean
Если true, он записывает "standalone=yes"; if false, он записывает "standalone=no".
Возвращаемое значение
Задача, представляющая асинхронную WriteStartDocument операцию.
Исключения
Метод XmlWriter был вызван до завершения предыдущей асинхронной операции. В этом случае InvalidOperationException создается сообщение "Асинхронная операция уже выполняется".
–или–
Асинхронный XmlWriter метод был вызван без задания флага Asynctrue. В этом случае InvalidOperationException создается сообщение "Set XmlWriterSettings.Async to true, если вы хотите использовать Асинхронные методы".
Комментарии
Это асинхронная версия WriteStartDocumentс той же функциональностью. Чтобы использовать этот метод, необходимо задать для флага Asynctrueзначение .
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых WriteStartDocument(Boolean).
См. также раздел
- Асинхронное программирование (C#)
- Асинхронное программирование с помощью Async и Await (Visual Basic)
