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)

Source:

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)

Source:

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)

Source:

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)异常。