XmlWriter.WriteNameAsync(String) 方法

定义

命名空间:

System.Xml

程序集:

System.Xml.ReaderWriter.dll

程序集:

System.Xml.dll

程序集:

netstandard.dll

异步写出指定的名称，确保它是符合 W3C XML 1.0 建议 (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name)) 的有效名称。

C#

public virtual System.Threading.Tasks.Task WriteNameAsync (string name);

参数

name

String

要写入的名称。

返回

Task

表示 WriteName 异步操作的任务。

例外

InvalidOperationException

在上一次异步操作完成之前调用了 XmlWriter 方法。 在此情况下，会引发 InvalidOperationException 并显示消息“异步操作已在进行中。”

• 或 -

调用了 XmlWriter 异步方法，但未将 Async 标志设置为 true。 在这种情况下，将引发 InvalidOperationException 并显示消息“如果要使用异步方法，请将 XmlWriterSettings.Async 设置为 true”。

注解

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

适用于

另请参阅

• 异步编程 (C#)
• 使用 Async 和 Await 的异步编程 (Visual Basic)