XElement.SaveAsync Método

Definição

Namespace:

System.Xml.Linq

Assembly:

System.Xml.XDocument.dll

Sobrecargas

SaveAsync(Stream, SaveOptions, CancellationToken)	Gera saída de forma assíncrona do XElement para um Stream.
SaveAsync(XmlWriter, CancellationToken)	Gera saída de forma assíncrona do XElement para um XmlWriter.
SaveAsync(TextWriter, SaveOptions, CancellationToken)	Gera saída de forma assíncrona do XElement para um TextWriter.

SaveAsync(Stream, SaveOptions, CancellationToken)

Origem:

XElement.cs

Gera saída de forma assíncrona do XElement para um 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

Parâmetros

stream

Stream

O fluxo para saída do XML.

options

SaveOptions

Uma combinação bit a bit dos valores de enumeração que especifica as opções de serialização.

cancellationToken

CancellationToken

Um token que pode ser usado para solicitar o cancelamento da operação assíncrona.

Retornos

Task

Uma tarefa que representa a operação de gravação assíncrona.

Exceções

OperationCanceledException

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

Comentários

Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Save(Stream, SaveOptions).

SaveAsync(XmlWriter, CancellationToken)

Origem:

XElement.cs

Gera saída de forma assíncrona do XElement para um 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

Parâmetros

writer

XmlWriter

O gravador da saída do XML.

cancellationToken

CancellationToken

Um token que pode ser usado para solicitar o cancelamento da operação assíncrona.

Retornos

Task

Uma tarefa que representa a operação de gravação assíncrona.

Exceções

OperationCanceledException

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

Comentários

Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Save(XmlWriter).

SaveAsync(TextWriter, SaveOptions, CancellationToken)

Origem:

XElement.cs

Gera saída de forma assíncrona do XElement para um 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

Parâmetros

textWriter

TextWriter

O gravador da saída do XML.

options

SaveOptions

Uma combinação bit a bit dos valores de enumeração que especifica as opções de serialização.

cancellationToken

CancellationToken

Um token que pode ser usado para solicitar o cancelamento da operação assíncrona.

Retornos

Task

Uma tarefa que representa a operação de gravação assíncrona.

Exceções

OperationCanceledException

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

Comentários

Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Save(TextWriter, SaveOptions).