XElement.LoadAsync 方法

定義

命名空間:

System.Xml.Linq

組件:

System.Xml.XDocument.dll

多載

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，並使用指定的串流來將其基礎 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，並使用指定的文字讀取器來將其基礎 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，並使用指定的 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) 擲回的例外狀況。