XElement.SaveAsync 方法

定义

命名空间:

System.Xml.Linq

程序集:

System.Xml.XDocument.dll

重载

SaveAsync(Stream, SaveOptions, CancellationToken)	将此 XElement 异步输出到 Stream。
SaveAsync(XmlWriter, CancellationToken)	将此 XElement 异步输出到 XmlWriter。
SaveAsync(TextWriter, SaveOptions, CancellationToken)	将此 XElement 异步输出到 TextWriter。

SaveAsync(Stream, SaveOptions, CancellationToken)

Source:

XElement.cs

将此 XElement 异步输出到 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

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

注解

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

SaveAsync(XmlWriter, CancellationToken)

Source:

XElement.cs

将此 XElement 异步输出到 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(TextWriter, SaveOptions, CancellationToken)

Source:

XElement.cs

将此 XElement 异步输出到 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

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

注解

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