XElement.SaveAsync 方法

定義

命名空間:

System.Xml.Linq

組件:

netstandard.dll, System.Xml.XDocument.dll

多載

名稱	Description
SaveAsync(Stream, SaveOptions, CancellationToken)	非同步輸出為 XElementStream。
SaveAsync(XmlWriter, CancellationToken)	非同步輸出為 XElementXmlWriter。
SaveAsync(TextWriter, SaveOptions, CancellationToken)	非同步輸出為 XElementTextWriter。

SaveAsync(Stream, SaveOptions, CancellationToken)

來源:

XElement.cs

非同步輸出為 XElementStream。

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

非同步輸出為 XElementXmlWriter。

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

非同步輸出為 XElementTextWriter。

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)拋出的例外。