XElement.SaveAsync Metoda

Definice

Obor názvů:

System.Xml.Linq

Sestavení:

System.Xml.XDocument.dll

Přetížení

SaveAsync(Stream, SaveOptions, CancellationToken)	Asynchronně to XElement vypíše na Stream.
SaveAsync(XmlWriter, CancellationToken)	Asynchronně vypíše tento XElement výstup do objektu XmlWriter.
SaveAsync(TextWriter, SaveOptions, CancellationToken)	Asynchronně to XElement vypíše na TextWriter.

SaveAsync(Stream, SaveOptions, CancellationToken)

Source:

XElement.cs

Asynchronně to XElement vypíše na 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

Parametry

stream

Stream

Datový proud, do který má být výstup XML.

options

SaveOptions

Bitové kombinace hodnot výčtu, které určují možnosti serializace.

cancellationToken

CancellationToken

Token, který lze použít k vyžádání zrušení asynchronní operace.

Návraty

Task

Úloha představující asynchronní operaci uložení.

Výjimky

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.

Poznámky

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Save(Stream, SaveOptions).

SaveAsync(XmlWriter, CancellationToken)

Source:

XElement.cs

Asynchronně vypíše tento XElement výstup do objektu 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

Parametry

writer

XmlWriter

Zapisovač pro výstup XML do.

cancellationToken

CancellationToken

Token, který lze použít k vyžádání zrušení asynchronní operace.

Návraty

Task

Úloha představující asynchronní operaci uložení.

Výjimky

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.

Poznámky

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Save(XmlWriter).

SaveAsync(TextWriter, SaveOptions, CancellationToken)

Source:

XElement.cs

Asynchronně to XElement vypíše na 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

Parametry

textWriter

TextWriter

Zapisovač pro výstup XML do.

options

SaveOptions

Bitové kombinace hodnot výčtu, které určují možnosti serializace.

cancellationToken

CancellationToken

Token, který lze použít k vyžádání zrušení asynchronní operace.

Návraty

Task

Úloha představující asynchronní operaci uložení.

Výjimky

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.

Poznámky

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Save(TextWriter, SaveOptions).