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)

來源:

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)

來源:

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)

來源:

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) 擲回的例外狀況。