XmlWriter.WriteCommentAsync(String) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Асинхронно записывает комментарий <!--...-->, содержащий заданный текст.
public:
virtual System::Threading::Tasks::Task ^ WriteCommentAsync(System::String ^ text);
public virtual System.Threading.Tasks.Task WriteCommentAsync (string text);
public virtual System.Threading.Tasks.Task WriteCommentAsync (string? text);
abstract member WriteCommentAsync : string -> System.Threading.Tasks.Task
override this.WriteCommentAsync : string -> System.Threading.Tasks.Task
Public Overridable Function WriteCommentAsync (text As String) As Task
Параметры
- text
- String
Текст, записываемый в примечание.
Возвращаемое значение
Задача, представляющая асинхронную операцию WriteComment
.
Исключения
Метод XmlWriter вызван перед завершением предыдущей асинхронной операции. В этом случае возникает исключение InvalidOperationException с сообщением "Асинхронная операция уже выполняется".
-или-
Асинхронный метод XmlWriter вызван без присваивания флагу Async значения true
. В этом случае вызывается исключение InvalidOperationException с сообщением "Задайте параметру XmlWriterSettings.Async значение true, если вы хотите использовать асинхронные методы".
Комментарии
Это асинхронная версия WriteComment, с той же функциональностью. Чтобы использовать этот метод, необходимо задать для флага Async true
значение .