XDocument.SaveAsync Метод

Определение

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

System.Xml.Linq

Сборки:

netstandard.dll, 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).