XDocument.SaveAsync 方法

定义

命名空间:

System.Xml.Linq

程序集:

System.Xml.XDocument.dll

重载

SaveAsync(XmlWriter, CancellationToken)	将此 XDocument 写入到 XmlWriter。
SaveAsync(Stream, SaveOptions, CancellationToken)	将此 XDocument 输出到 Stream。
SaveAsync(TextWriter, SaveOptions, CancellationToken)	将此 XDocument 写入到 TextWriter。

SaveAsync(XmlWriter, CancellationToken)

Source:

XDocument.cs

将此 XDocument 写入到 XmlWriter。

public:
 System::Threading::Tasks::Task ^ SaveAsync(System::Xml::XmlWriter ^ writer, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task SaveAsync (System.Xml.XmlWriter writer, System.Threading.CancellationToken cancellationToken);

member this.SaveAsync : System.Xml.XmlWriter * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function SaveAsync (writer As XmlWriter, cancellationToken As CancellationToken) As Task

参数

writer

XmlWriter

要向其输出 XML 的编写器。

cancellationToken

CancellationToken

取消标记。

返回

Task

表示异步保存操作的任务。

例外

OperationCanceledException

取消令牌已取消。 此异常存储在返回的任务中。

注解

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

SaveAsync(Stream, SaveOptions, CancellationToken)

Source:

XDocument.cs

将此 XDocument 输出到 Stream。

public:
 System::Threading::Tasks::Task ^ SaveAsync(System::IO::Stream ^ stream, System::Xml::Linq::SaveOptions options, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task SaveAsync (System.IO.Stream stream, System.Xml.Linq.SaveOptions options, System.Threading.CancellationToken cancellationToken);

member this.SaveAsync : System.IO.Stream * System.Xml.Linq.SaveOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function SaveAsync (stream As Stream, options As SaveOptions, cancellationToken As CancellationToken) As Task

参数

stream

Stream

要向其写入 XML 的流。

options

SaveOptions

一组加载选项。

cancellationToken

CancellationToken

取消标记。

返回

Task

表示异步保存操作的任务。

例外

OperationCanceledException

取消令牌已取消。 此异常存储在返回的任务中。

注解

如果 SaveOptions.DisableFormatting 设置了 ，则不缩进输出。 如果 SaveOptions.OmitDuplicateNamespaces 设置了 ，则将删除重复的命名空间声明。

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

SaveAsync(TextWriter, SaveOptions, CancellationToken)

Source:

XDocument.cs

将此 XDocument 写入到 TextWriter。

public:
 System::Threading::Tasks::Task ^ SaveAsync(System::IO::TextWriter ^ textWriter, System::Xml::Linq::SaveOptions options, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task SaveAsync (System.IO.TextWriter textWriter, System.Xml.Linq.SaveOptions options, System.Threading.CancellationToken cancellationToken);

member this.SaveAsync : System.IO.TextWriter * System.Xml.Linq.SaveOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function SaveAsync (textWriter As TextWriter, options As SaveOptions, cancellationToken As CancellationToken) As Task

参数

textWriter

TextWriter

要向其输出 XML 的文本编写器。

options

SaveOptions

一组加载选项。

cancellationToken

CancellationToken

取消标记。

返回

Task

表示异步保存操作的任务。

例外

OperationCanceledException

取消令牌已取消。 此异常存储在返回的任务中。

注解

如果 SaveOptions.DisableFormatting 设置了 ，则不缩进输出。 如果 SaveOptions.OmitDuplicateNamespaces 设置了 ，则将删除重复的命名空间声明。

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