XDocument.LoadAsync 方法

定义

命名空间:

System.Xml.Linq

程序集:

System.Xml.XDocument.dll

重载

LoadAsync(TextReader, LoadOptions, CancellationToken)	创建新的 XDocument 并使用指定的 TextReader 参数初始化其基础 XML 树，可以选择保留空格。
LoadAsync(XmlReader, LoadOptions, CancellationToken)	创建包含指定的 XmlReader 的内容的新 XDocument。
LoadAsync(Stream, LoadOptions, CancellationToken)	以异步方式创建新的 XDocument 并从指定的流初始化其基础 XML 树，可以选择保留空格。

LoadAsync(TextReader, LoadOptions, CancellationToken)

Source:

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>

包含指定的 TextReader 的内容的新 XDocument。

例外

OperationCanceledException

取消令牌已取消。 此异常存储在返回的任务中。

注解

如果 LoadOptions.PreserveWhitespace 设置为 ，则 XmlReaderSettings.IgnoreWhitespace 属性设置为 false。

此方法存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。 如果异常存储在返回的任务中，则在等待任务时将引发该异常。 使用异常（如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅 引发的 Load(TextReader, LoadOptions)异常。

LoadAsync(XmlReader, LoadOptions, CancellationToken)

Source:

XDocument.cs

创建包含指定的 XmlReader 的内容的新 XDocument。

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>

包含指定的 XmlReader 的内容的新 XDocument。

例外

OperationCanceledException

取消令牌已取消。 此异常存储在返回的任务中。

注解

此方法存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。 如果异常存储在返回的任务中，则在等待任务时将引发该异常。 使用异常（如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅 引发的 Load(XmlReader, LoadOptions)异常。

LoadAsync(Stream, LoadOptions, CancellationToken)

Source:

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>

包含指定的 Stream 的内容的新 XDocument。

例外

OperationCanceledException

取消令牌已取消。 此异常存储在返回的任务中。

注解

如果 LoadOptions.PreserveWhitespace 设置为 ，则基础 XmlReaderSettings.IgnoreWhitespace 属性设置为 false。

此方法存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。 如果异常存储在返回的任务中，则在等待任务时将引发该异常。 使用异常（如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅 引发的 Load(Stream, LoadOptions)异常。