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).