XDocument.LoadAsync Метод

Определение

Пространство имен:

System.Xml.Linq

Сборки:

netstandard.dll, System.Xml.XDocument.dll

Перегрузки

Имя	Описание
LoadAsync(TextReader, LoadOptions, CancellationToken)	Создает новое XDocument и инициализирует его базовое XML-дерево с помощью указанного TextReader параметра, при необходимости сохраняя пробелы.
LoadAsync(XmlReader, LoadOptions, CancellationToken)	Создает новое XDocument , содержащее содержимое указанного XmlReaderобъекта.
LoadAsync(Stream, LoadOptions, CancellationToken)	Асинхронно создает новый XDocument и инициализирует его базовое XML-дерево из указанного потока, при необходимости сохраняя пробелы.

LoadAsync(TextReader, LoadOptions, CancellationToken)

Исходный код:

XDocument.cs

Создает новое XDocument и инициализирует его базовое XML-дерево с помощью указанного TextReader параметра, при необходимости сохраняя пробелы.

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

Средство чтения, содержащее необработанный XML-код для чтения в только что созданное.XDocument

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

Средство чтения, содержащее XML-файл, который будет считываться в новый XDocument.

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

Поток, содержащий необработанный XML-код для чтения в только что созданное.XDocument

options

LoadOptions

Набор параметров загрузки.

cancellationToken

CancellationToken

Токен отмены.

Возвращаемое значение

Task<XDocument>

Новый объект XDocument, содержащий содержимое указанного Streamобъекта.

Исключения

OperationCanceledException

Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.

Комментарии

Если LoadOptions.PreserveWhitespace задано, для базового XmlReaderSettings.IgnoreWhitespace свойства задано falseзначение .

Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых Load(Stream, LoadOptions).