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)

來源:

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)

來源:

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)

來源:

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