XmlWriter.WriteEndDocumentAsync 方法

定义

命名空间:

System.Xml

程序集:

netstandard.dll, System.Xml.ReaderWriter.dll

Source:

XmlWriterAsync.cs

异步关闭任何打开的元素或属性，并将编写器重新置于“开始”状态。

public:
 virtual System::Threading::Tasks::Task ^ WriteEndDocumentAsync();

public virtual System.Threading.Tasks.Task WriteEndDocumentAsync();

abstract member WriteEndDocumentAsync : unit -> System.Threading.Tasks.Task
override this.WriteEndDocumentAsync : unit -> System.Threading.Tasks.Task

Public Overridable Function WriteEndDocumentAsync () As Task

返回

Task

表示异步 WriteEndDocument 操作的任务。

例外

InvalidOperationException

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

-或-

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

注解

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

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

另请参阅

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