XDocument.LoadAsync 方法

定義

命名空間:

System.Xml.Linq

組件:

System.Xml.XDocument.dll

多載

LoadAsync(TextReader, LoadOptions, CancellationToken)	建立新的 XDocument，並使用指定的 TextReader 參數來將其基礎 XML 樹狀結構初始化 (選擇性地保留空白字元)。
LoadAsync(XmlReader, LoadOptions, CancellationToken)	建立新的 XDocument，其中包含指定 XmlReader 的內容。
LoadAsync(Stream, LoadOptions, CancellationToken)	以非同步方式建立新的 XDocument，並從指定的串流將其基礎 XML 樹狀結構初始化 (選擇性地保留空白字元)。

LoadAsync(TextReader, LoadOptions, CancellationToken)

來源:

XDocument.cs

建立新的 XDocument，並使用指定的 TextReader 參數來將其基礎 XML 樹狀結構初始化 (選擇性地保留空白字元)。

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

public static System.Threading.Tasks.Task<System.Xml.Linq.XDocument> 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.XDocument>

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

參數

textReader

TextReader

包含要讀取至新建立 XDocument 之原始 XML 的讀取器。

options

LoadOptions

一組載入選項。

cancellationToken

CancellationToken

取消語彙基元。

傳回

Task<XDocument>

新的 XDocument，其中包含指定 TextReader 的內容。

例外狀況

OperationCanceledException

取消權杖已取消。 此例外狀況會儲存在傳回的工作中。

備註

如果 LoadOptions.PreserveWhitespace 已設定，則 XmlReaderSettings.IgnoreWhitespace 屬性會設定為 false 。

這個方法會儲存在工作中，它會傳回方法同步對應專案可以擲回的所有非使用狀況例外狀況。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用狀況例外狀況，例如 ArgumentException ，仍會同步擲回。 如需預存的例外狀況，請參閱 所 Load(TextReader, LoadOptions) 擲回的例外狀況。

LoadAsync(XmlReader, LoadOptions, CancellationToken)

來源:

XDocument.cs

建立新的 XDocument，其中包含指定 XmlReader 的內容。

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

public static System.Threading.Tasks.Task<System.Xml.Linq.XDocument> 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.XDocument>

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

參數

reader

XmlReader

包含要讀取至新 XDocument 之 XML 的讀取器。

options

LoadOptions

一組載入選項。

cancellationToken

CancellationToken

取消語彙基元。

傳回

Task<XDocument>

新的 XDocument，其中包含指定 XmlReader 的內容。

例外狀況

OperationCanceledException

取消權杖已取消。 此例外狀況會儲存在傳回的工作中。

備註

這個方法會儲存在工作中，它會傳回方法同步對應專案可以擲回的所有非使用狀況例外狀況。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用狀況例外狀況，例如 ArgumentException ，仍會同步擲回。 如需預存的例外狀況，請參閱 所 Load(XmlReader, LoadOptions) 擲回的例外狀況。

LoadAsync(Stream, LoadOptions, CancellationToken)

來源:

XDocument.cs

以非同步方式建立新的 XDocument，並從指定的串流將其基礎 XML 樹狀結構初始化 (選擇性地保留空白字元)。

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

public static System.Threading.Tasks.Task<System.Xml.Linq.XDocument> 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.XDocument>

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

參數

stream

Stream

包含要讀取至新建立 XDocument 之原始 XML 的串流。

options

LoadOptions

一組載入選項。

cancellationToken

CancellationToken

取消語彙基元。

傳回

Task<XDocument>

新的 XDocument，其中包含指定 Stream 的內容。

例外狀況

OperationCanceledException

取消權杖已取消。 此例外狀況會儲存在傳回的工作中。

備註

如果 LoadOptions.PreserveWhitespace 已設定，基礎 XmlReaderSettings.IgnoreWhitespace 屬性會設定為 false 。

這個方法會儲存在工作中，它會傳回方法同步對應專案可以擲回的所有非使用狀況例外狀況。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用狀況例外狀況，例如 ArgumentException ，仍會同步擲回。 如需預存的例外狀況，請參閱 所 Load(Stream, LoadOptions) 擲回的例外狀況。