XElement.SaveAsync Метод

Определение

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

System.Xml.Linq

Сборка:

System.Xml.XDocument.dll

Перегрузки

SaveAsync(Stream, SaveOptions, CancellationToken)	Асинхронно выводит XElement в Stream.
SaveAsync(XmlWriter, CancellationToken)	Асинхронно выводит XElement в XmlWriter.
SaveAsync(TextWriter, SaveOptions, CancellationToken)	Асинхронно выводит XElement в TextWriter.

SaveAsync(Stream, SaveOptions, CancellationToken)

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

XElement.cs

Асинхронно выводит XElement в Stream.

public:
 System::Threading::Tasks::Task ^ SaveAsync(System::IO::Stream ^ stream, System::Xml::Linq::SaveOptions options, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task SaveAsync (System.IO.Stream stream, System.Xml.Linq.SaveOptions options, System.Threading.CancellationToken cancellationToken);

member this.SaveAsync : System.IO.Stream * System.Xml.Linq.SaveOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function SaveAsync (stream As Stream, options As SaveOptions, cancellationToken As CancellationToken) As Task

Параметры

stream

Stream

Поток для вывода XML.

options

SaveOptions

Побитовая комбинация значений перечисления, определяющих параметры сериализации.

cancellationToken

CancellationToken

Токен, который может быть использован для запроса отмены асинхронной операции.

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

Task

Задача, представляющая асинхронную операцию сохранения.

Исключения

OperationCanceledException

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

Комментарии

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

SaveAsync(XmlWriter, CancellationToken)

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

XElement.cs

Асинхронно выводит XElement в XmlWriter.

public:
 System::Threading::Tasks::Task ^ SaveAsync(System::Xml::XmlWriter ^ writer, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task SaveAsync (System.Xml.XmlWriter writer, System.Threading.CancellationToken cancellationToken);

member this.SaveAsync : System.Xml.XmlWriter * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function SaveAsync (writer As XmlWriter, cancellationToken As CancellationToken) As Task

Параметры

writer

XmlWriter

Модуль записи для вывода XML.

cancellationToken

CancellationToken

Токен, который может быть использован для запроса отмены асинхронной операции.

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

Task

Задача, представляющая асинхронную операцию сохранения.

Исключения

OperationCanceledException

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

Комментарии

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

SaveAsync(TextWriter, SaveOptions, CancellationToken)

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

XElement.cs

Асинхронно выводит XElement в TextWriter.

public:
 System::Threading::Tasks::Task ^ SaveAsync(System::IO::TextWriter ^ textWriter, System::Xml::Linq::SaveOptions options, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task SaveAsync (System.IO.TextWriter textWriter, System.Xml.Linq.SaveOptions options, System.Threading.CancellationToken cancellationToken);

member this.SaveAsync : System.IO.TextWriter * System.Xml.Linq.SaveOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function SaveAsync (textWriter As TextWriter, options As SaveOptions, cancellationToken As CancellationToken) As Task

Параметры

textWriter

TextWriter

Модуль записи для вывода XML.

options

SaveOptions

Побитовая комбинация значений перечисления, определяющих параметры сериализации.

cancellationToken

CancellationToken

Токен, который может быть использован для запроса отмены асинхронной операции.

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

Task

Задача, представляющая асинхронную операцию сохранения.

Исключения

OperationCanceledException

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

Комментарии

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