XmlWriter.WriteStartAttributeAsync(String, String, String) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Асинхронно записывает начало атрибута с указанным префиксом, локальным именем и URI пространства имен.
protected public:
virtual System::Threading::Tasks::Task ^ WriteStartAttributeAsync(System::String ^ prefix, System::String ^ localName, System::String ^ ns);protected internal virtual System.Threading.Tasks.Task WriteStartAttributeAsync(string prefix, string localName, string ns);protected internal virtual System.Threading.Tasks.Task WriteStartAttributeAsync(string? prefix, string localName, string? ns);abstract member WriteStartAttributeAsync : string * string * string -> System.Threading.Tasks.Task
override this.WriteStartAttributeAsync : string * string * string -> System.Threading.Tasks.TaskProtected Friend Overridable Function WriteStartAttributeAsync (prefix As String, localName As String, ns As String) As TaskПараметры
- prefix
- String
Префикс пространства имен атрибута.
- localName
- String
Локальное имя атрибута.
- ns
- String
Универсальный код ресурса (URI) пространства имен для атрибута.
Возвращаемое значение
Задача, представляющая асинхронную WriteStartAttribute операцию.
Исключения
Метод XmlWriter был вызван до завершения предыдущей асинхронной операции. В этом случае InvalidOperationException создается сообщение "Асинхронная операция уже выполняется".
–или–
Асинхронный XmlWriter метод был вызван без задания флага Asynctrue. В этом случае InvalidOperationException создается сообщение "Set XmlWriterSettings.Async to true, если вы хотите использовать Асинхронные методы".
Комментарии
Это асинхронная версия WriteStartAttributeс той же функциональностью. Чтобы использовать этот метод, необходимо задать для флага Asynctrueзначение .
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых WriteStartAttribute(String, String, String).
