XElement.LoadAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| Имя | Описание |
|---|---|
| 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.cs
- Исходный код:
- XElement.cs
- Исходный код:
- XElement.cs
- Исходный код:
- 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
Маркер, который можно использовать для запроса отмены асинхронной операции.
Возвращаемое значение
Новое XElement , содержащее содержимое указанного потока.
Исключения
Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.
Комментарии
Если options задано PreserveWhitespaceзначение , IgnoreWhitespace то для свойства задано falseзначение .
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых Load(Stream, LoadOptions).
Применяется к
LoadAsync(TextReader, LoadOptions, CancellationToken)
- Исходный код:
- XElement.cs
- Исходный код:
- XElement.cs
- Исходный код:
- XElement.cs
- Исходный код:
- XElement.cs
- Исходный код:
- 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
Маркер, который можно использовать для запроса отмены асинхронной операции.
Возвращаемое значение
Новое XElement , содержащее содержимое указанного средства чтения.
Исключения
Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.
Комментарии
Если options задано PreserveWhitespaceзначение , IgnoreWhitespace то для свойства задано falseзначение .
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых Load(TextReader, LoadOptions).
Применяется к
LoadAsync(XmlReader, LoadOptions, CancellationToken)
- Исходный код:
- XElement.cs
- Исходный код:
- XElement.cs
- Исходный код:
- XElement.cs
- Исходный код:
- XElement.cs
- Исходный код:
- 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
Маркер, который можно использовать для запроса отмены асинхронной операции.
Возвращаемое значение
Новое XElement , содержащее содержимое указанного средства чтения.
Исключения
Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.
Комментарии
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых Load(XmlReader, LoadOptions).