XmlWriter.WriteNameAsync(String) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Асинхронно записывает указанное имя, гарантируя его допустимость согласно рекомендации W3C по языку XML версии 1.0 (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
public:
virtual System::Threading::Tasks::Task ^ WriteNameAsync(System::String ^ name);
public virtual System.Threading.Tasks.Task WriteNameAsync (string name);
abstract member WriteNameAsync : string -> System.Threading.Tasks.Task
override this.WriteNameAsync : string -> System.Threading.Tasks.Task
Public Overridable Function WriteNameAsync (name As String) As Task
Параметры
- name
- String
Записываемое имя.
Возвращаемое значение
Задача, представляющая асинхронную операцию WriteName
.
Исключения
Метод XmlWriter вызван перед завершением предыдущей асинхронной операции. В этом случае возникает исключение InvalidOperationException с сообщением "Асинхронная операция уже выполняется".
-или-
Асинхронный метод XmlWriter вызван без присваивания флагу Async значения true
. В этом случае вызывается исключение InvalidOperationException с сообщением "Задайте параметру XmlWriterSettings.Async значение true, если вы хотите использовать асинхронные методы".
Комментарии
Это асинхронная версия WriteNameс теми же функциями. Чтобы использовать этот метод, необходимо задать для флага Async true
значение .