XmlWriter.WriteDocTypeAsync(String, String, String, String) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Асинхронно записывает объявление DOCTYPE с указанным именем и необязательными атрибутами.
public:
virtual System::Threading::Tasks::Task ^ WriteDocTypeAsync(System::String ^ name, System::String ^ pubid, System::String ^ sysid, System::String ^ subset);public virtual System.Threading.Tasks.Task WriteDocTypeAsync(string name, string pubid, string sysid, string subset);public virtual System.Threading.Tasks.Task WriteDocTypeAsync(string name, string? pubid, string? sysid, string? subset);abstract member WriteDocTypeAsync : string * string * string * string -> System.Threading.Tasks.Task
override this.WriteDocTypeAsync : string * string * string * string -> System.Threading.Tasks.TaskPublic Overridable Function WriteDocTypeAsync (name As String, pubid As String, sysid As String, subset As String) As TaskПараметры
- name
- String
Имя DOCTYPE. Это должно быть непусто.
- pubid
- String
Если он не имеет значения NULL, он также записывает public pubid "sysid", где pubid и sysid заменяются значением заданных аргументов.
- sysid
- String
Если pubid значение равно null null, sysid оно записывает SYSTEM sysid, где sysid заменяется значением этого аргумента.
- subset
- String
Если он не имеет значения NULL, он записывает [подмножество], где подмножество заменяется значением этого аргумента.
Возвращаемое значение
Задача, представляющая асинхронную WriteDocType операцию.
Исключения
Метод XmlWriter был вызван до завершения предыдущей асинхронной операции. В этом случае InvalidOperationException создается сообщение "Асинхронная операция уже выполняется".
–или–
Асинхронный XmlWriter метод был вызван без задания флага Asynctrue. В этом случае InvalidOperationException создается сообщение "Set XmlWriterSettings.Async to true, если вы хотите использовать Асинхронные методы".
Комментарии
Это асинхронная версия WriteDocTypeс той же функциональностью. Чтобы использовать этот метод, необходимо задать для флага Asynctrueзначение .
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых WriteDocType(String, String, String, String).
