Поделиться через


XDocument.LoadAsync Метод

Определение

Перегрузки

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.cs
Исходный код:
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

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

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

Новый XDocument с содержимым указанного TextReader.

Исключения

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

Комментарии

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

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

Применяется к

LoadAsync(XmlReader, LoadOptions, CancellationToken)

Исходный код:
XDocument.cs
Исходный код:
XDocument.cs
Исходный код:
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

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

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

Новый XDocument с содержимым указанного XmlReader.

Исключения

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

Комментарии

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

Применяется к

LoadAsync(Stream, LoadOptions, CancellationToken)

Исходный код:
XDocument.cs
Исходный код:
XDocument.cs
Исходный код:
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

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

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

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

Исключения

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

Комментарии

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

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

Применяется к