XElement.LoadAsync 方法

定義

命名空間:: System.Xml.Linq

組件:: netstandard.dll, System.Xml.XDocument.dll

組件:: System.Xml.XDocument.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

名稱	Description
LoadAsync(Stream, LoadOptions, CancellationToken)	非同步建立新 XElement 一棵，並使用指定的串流初始化其底層 XML 樹，並可選擇保留空白空間。
LoadAsync(TextReader, LoadOptions, CancellationToken)	非同步建立新 XElement 一棵，並使用指定的文字讀取器初始化其底層 XML 樹，並可選擇保留留白。
LoadAsync(XmlReader, LoadOptions, CancellationToken)	非同步建立新 XElement 一棵，並使用指定的 XML 讀取器初始化其底層 XML 樹，並可選擇保留空白。

LoadAsync(Stream, LoadOptions, CancellationToken)

來源:: XElement.cs

來源:: XElement.cs

來源:: XElement.cs

來源:: XElement.cs

來源:: XElement.cs

非同步建立新 XElement 一棵，並使用指定的串流初始化其底層 XML 樹，並可選擇保留空白空間。

public:
 static System::Threading::Tasks::Task<System::Xml::Linq::XElement ^> ^ LoadAsync(System::IO::Stream ^ stream, System::Xml::Linq::LoadOptions options, System::Threading::CancellationToken cancellationToken);

public static System.Threading.Tasks.Task<System.Xml.Linq.XElement> LoadAsync(System.IO.Stream stream, System.Xml.Linq.LoadOptions options, System.Threading.CancellationToken cancellationToken);

static member LoadAsync : System.IO.Stream * System.Xml.Linq.LoadOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Xml.Linq.XElement>

Public Shared Function LoadAsync (stream As Stream, options As LoadOptions, cancellationToken As CancellationToken) As Task(Of XElement)

參數

stream: Stream

包含原始 XML 的串流。

options: LoadOptions

一個位元組合列舉值，指定用以解析 XML 的載入選項。

cancellationToken: CancellationToken

一個可以用來請求取消非同步操作的權杖。

傳回

Task<XElement>

一個包含指定串流內容的新訊息 XElement 。

例外狀況

OperationCanceledException

取消令牌也被取消了。此例外會儲存在回傳的任務中。

備註

若 options 設為 PreserveWhitespace，則 IgnoreWhitespace 性質設為 false。

此方法在任務中儲存所有非使用例外，該方法的同步對應程式可拋出這些例外。如果回傳的任務中儲存了例外，該例外會在等待任務時拋出。使用例外錯誤，例如 ArgumentException，仍會同步拋出。關於儲存的例外，請參見由 Load(Stream, LoadOptions)拋出的例外。

適用於

LoadAsync(TextReader, LoadOptions, CancellationToken)

來源:: XElement.cs

來源:: XElement.cs

來源:: XElement.cs

來源:: XElement.cs

來源:: XElement.cs

非同步建立新 XElement 一棵，並使用指定的文字讀取器初始化其底層 XML 樹，並可選擇保留留白。

public:
 static System::Threading::Tasks::Task<System::Xml::Linq::XElement ^> ^ LoadAsync(System::IO::TextReader ^ textReader, System::Xml::Linq::LoadOptions options, System::Threading::CancellationToken cancellationToken);

public static System.Threading.Tasks.Task<System.Xml.Linq.XElement> LoadAsync(System.IO.TextReader textReader, System.Xml.Linq.LoadOptions options, System.Threading.CancellationToken cancellationToken);

static member LoadAsync : System.IO.TextReader * System.Xml.Linq.LoadOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Xml.Linq.XElement>

Public Shared Function LoadAsync (textReader As TextReader, options As LoadOptions, cancellationToken As CancellationToken) As Task(Of XElement)

參數

textReader: TextReader

一個包含原始 XML 的讀取器。

options: LoadOptions

一個位元組合列舉值，指定用以解析 XML 的載入選項。

cancellationToken: CancellationToken

一個可以用來請求取消非同步操作的權杖。

傳回

Task<XElement>

一個包含指定閱讀器內容的新文件 XElement 。

例外狀況

OperationCanceledException

取消令牌也被取消了。此例外會儲存在回傳的任務中。

備註

若 options 設為 PreserveWhitespace，則 IgnoreWhitespace 性質設為 false。

此方法在任務中儲存所有非使用例外，該方法的同步對應程式可拋出這些例外。如果回傳的任務中儲存了例外，該例外會在等待任務時拋出。使用例外錯誤，例如 ArgumentException，仍會同步拋出。關於儲存的例外，請參見由 Load(TextReader, LoadOptions)拋出的例外。

適用於

LoadAsync(XmlReader, LoadOptions, CancellationToken)

來源:: XElement.cs

來源:: XElement.cs

來源:: XElement.cs

來源:: XElement.cs

來源:: XElement.cs

非同步建立新 XElement 一棵，並使用指定的 XML 讀取器初始化其底層 XML 樹，並可選擇保留空白。

public:
 static System::Threading::Tasks::Task<System::Xml::Linq::XElement ^> ^ LoadAsync(System::Xml::XmlReader ^ reader, System::Xml::Linq::LoadOptions options, System::Threading::CancellationToken cancellationToken);

public static System.Threading.Tasks.Task<System.Xml.Linq.XElement> LoadAsync(System.Xml.XmlReader reader, System.Xml.Linq.LoadOptions options, System.Threading.CancellationToken cancellationToken);

static member LoadAsync : System.Xml.XmlReader * System.Xml.Linq.LoadOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Xml.Linq.XElement>

Public Shared Function LoadAsync (reader As XmlReader, options As LoadOptions, cancellationToken As CancellationToken) As Task(Of XElement)

參數

reader: XmlReader

一個包含待讀取 XML 的讀取器。

options: LoadOptions

一個位元組合列舉值，指定用以解析 XML 的載入選項。

cancellationToken: CancellationToken

一個可以用來請求取消非同步操作的權杖。

傳回

Task<XElement>

一個包含指定閱讀器內容的新文件 XElement 。

例外狀況

OperationCanceledException

取消令牌也被取消了。此例外會儲存在回傳的任務中。

備註

此方法在任務中儲存所有非使用例外，該方法的同步對應程式可拋出這些例外。如果回傳的任務中儲存了例外，該例外會在等待任務時拋出。使用例外錯誤，例如 ArgumentException，仍會同步拋出。關於儲存的例外，請參見由 Load(XmlReader, LoadOptions)拋出的例外。

適用於

意見反應

此頁面對您有幫助嗎？