XmlWriter.WriteElementStringAsync(String, String, String, String) 方法

定义

命名空间:

System.Xml

程序集:

netstandard.dll, System.Xml.ReaderWriter.dll

Source:

XmlWriter.cs

异步写入具有指定前缀、本地名称、命名空间 URI 和值的元素。

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

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

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

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

参数

prefix

String

元素的前缀。

localName

String

元素的本地名称。

ns

String

元素的命名空间 URI。

value

String

元素的值。

返回

Task

表示异步 WriteElementString 操作的任务。

例外

InvalidOperationException

在上一个异步操作完成之前调用了一个 XmlWriter 方法。 在这种情况下， InvalidOperationException 会引发消息“正在进行异步操作”。

-或-

未将标志设置为 /> 即可调用异步方法。 在这种情况下，如果想要使用 Async 方法， InvalidOperationException 则会引发消息“将 XmlWriterSettings.Async 设置为 true”。

注解

这是具有相同功能的异步版本 WriteElementString。 若要使用此方法，必须将标志设置为 Asynctrue。

此方法存储在任务中，它返回该方法的同步对应项可以引发的所有非使用异常。 如果异常存储在返回的任务中，则等待任务时将引发该异常。 使用情况异常（例如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅由 WriteElementString(String, String, String, String)..

另请参阅

• 异步编程 （C#）
• 使用 Async 和 Await 进行异步编程（Visual Basic）