XDocument.SaveAsync Método

Definición

Espacio de nombres:

System.Xml.Linq

Ensamblado:

System.Xml.XDocument.dll

Sobrecargas

SaveAsync(XmlWriter, CancellationToken)	Escribe esta clase XDocument en un escritor XmlWriter.
SaveAsync(Stream, SaveOptions, CancellationToken)	Genera esta clase XDocument en un escritor Stream.
SaveAsync(TextWriter, SaveOptions, CancellationToken)	Escribe esta clase XDocument en un escritor TextWriter.

SaveAsync(XmlWriter, CancellationToken)

Source:

XDocument.cs

Escribe esta clase XDocument en un escritor 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

Escritor en el que se genera el XML.

cancellationToken

CancellationToken

Token de cancelación.

Devoluciones

Task

Tarea que representa la operación de guardado asincrónico.

Excepciones

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Comentarios

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, se siguen iniciando de forma sincrónica. Para ver las excepciones almacenadas, consulte las excepciones producidas por Save(XmlWriter).

SaveAsync(Stream, SaveOptions, CancellationToken)

Source:

XDocument.cs

Genera esta clase XDocument en un escritor 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

Flujo en el que se va a escribir el XML.

options

SaveOptions

Conjunto de opciones de carga.

cancellationToken

CancellationToken

Token de cancelación.

Devoluciones

Task

Tarea que representa la operación de guardado asincrónico.

Excepciones

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Comentarios

Si SaveOptions.DisableFormatting se establece, la salida no tiene sangría. Si SaveOptions.OmitDuplicateNamespaces se establece, se quitarán las declaraciones de espacio de nombres duplicadas.

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, se siguen iniciando de forma sincrónica. Para ver las excepciones almacenadas, consulte las excepciones producidas por Save(Stream, SaveOptions).

SaveAsync(TextWriter, SaveOptions, CancellationToken)

Source:

XDocument.cs

Escribe esta clase XDocument en un escritor 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

Escritor de texto que recibe el XML.

options

SaveOptions

Conjunto de opciones de carga.

cancellationToken

CancellationToken

Token de cancelación.

Devoluciones

Task

Tarea que representa la operación de guardado asincrónico.

Excepciones

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Comentarios

Si SaveOptions.DisableFormatting se establece, la salida no tiene sangría. Si SaveOptions.OmitDuplicateNamespaces se establece, se quitarán las declaraciones de espacio de nombres duplicadas.

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, se siguen iniciando de forma sincrónica. Para ver las excepciones almacenadas, consulte las excepciones producidas por Save(TextWriter, SaveOptions).