XDocument.SaveAsync Метод

Определение

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

System.Xml.Linq

Сборка:

System.Xml.XDocument.dll

Перегрузки

SaveAsync(XmlWriter, CancellationToken)	Записывает XDocument в XmlWriter.
SaveAsync(Stream, SaveOptions, CancellationToken)	Выводит XDocument в Stream.
SaveAsync(TextWriter, SaveOptions, CancellationToken)	Записывает XDocument в TextWriter.

SaveAsync(XmlWriter, CancellationToken)

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

XDocument.cs

Записывает XDocument в 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(Stream, SaveOptions, CancellationToken)

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

XDocument.cs

Выводит XDocument в 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

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

Комментарии

Если SaveOptions.DisableFormatting задано значение , выходные данные не отступы. Если SaveOptions.OmitDuplicateNamespaces задано значение , будут удалены повторяющиеся объявления пространств имен.

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

SaveAsync(TextWriter, SaveOptions, CancellationToken)

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

XDocument.cs

Записывает XDocument в 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

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

Комментарии

Если SaveOptions.DisableFormatting задано значение , выходные данные не отступы. Если SaveOptions.OmitDuplicateNamespaces задано значение , будут удалены повторяющиеся объявления пространств имен.

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