XmlWriter.WriteAttributeStringAsync(String, String, String, String) Метод

Определение

Пространство имен:

System.Xml

Сборки:

netstandard.dll, System.Xml.ReaderWriter.dll

Исходный код:

XmlWriterAsync.cs

Асинхронно записывает атрибут с указанным префиксом, локальным именем, URI пространства имен и значением.

public:
 System::Threading::Tasks::Task ^ WriteAttributeStringAsync(System::String ^ prefix, System::String ^ localName, System::String ^ ns, System::String ^ value);

public System.Threading.Tasks.Task WriteAttributeStringAsync(string? prefix, string localName, string? ns, string? value);

member this.WriteAttributeStringAsync : string * string * string * string -> System.Threading.Tasks.Task

Public Function WriteAttributeStringAsync (prefix As String, localName As String, ns As String, value As String) As Task

Параметры

prefix

String

Префикс пространства имен атрибута.

localName

String

Локальное имя атрибута.

ns

String

URI пространства имен атрибута.

value

String

Значение атрибута.

Возвращаемое значение

Task

Задача, представляющая асинхронную WriteAttributeString операцию.

Исключения

InvalidOperationException

Метод XmlWriter был вызван до завершения предыдущей асинхронной операции. В этом случае InvalidOperationException создается сообщение "Асинхронная операция уже выполняется".

–или–

Асинхронный XmlWriter метод был вызван без задания флага Asynctrue. В этом случае InvalidOperationException создается сообщение "Set XmlWriterSettings.Async to true, если вы хотите использовать Асинхронные методы".

Комментарии

Это асинхронная версия WriteAttributeStringс той же функциональностью. Чтобы использовать этот метод, необходимо задать для флага Asynctrueзначение .

Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых WriteAttributeString(String, String, String, String).

См. также раздел

• Асинхронное программирование (C#)
• Асинхронное программирование с помощью Async и Await (Visual Basic)