FileStream.FlushAsync(CancellationToken) Metoda

Definice

Obor názvů:

System.IO

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

FileStream.cs

Asynchronně vymaže všechny vyrovnávací paměti pro tento datový proud, způsobí zápis všech dat uložených do vyrovnávací paměti do souboru a monitoruje žádosti o zrušení.

public:
 override System::Threading::Tasks::Task ^ FlushAsync(System::Threading::CancellationToken cancellationToken);

public override System.Threading.Tasks.Task FlushAsync(System.Threading.CancellationToken cancellationToken);

override this.FlushAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overrides Function FlushAsync (cancellationToken As CancellationToken) As Task

Parametry

cancellationToken

CancellationToken

Token pro monitorování žádostí o zrušení.

Návraty

Task

Úloha, která představuje asynchronní operaci vyprázdnění.

Výjimky

ObjectDisposedException

Stream byl odstraněn.

OperationCanceledException

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

Poznámky

Tato metoda vyprázdní vyrovnávací paměti streamu .NET do souboru, ale neprázdní zprostředkující vyrovnávací paměti souborů v operačním systému. Pokud chcete zajistit, aby se všechna data uložená do vyrovnávací paměti zapisovala do základního úložného zařízení, použijte Flush(Boolean) metodu s parametrem nastaveným flushToDisk na true.

Pokud je operace zrušena před dokončením, vrácený úkol obsahuje Canceled hodnotu vlastnosti Status . Pokud je popisovač souboru odstraněn, vrácená úloha obsahuje ObjectDisposedException výjimku ve Exception vlastnosti.

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané Flush().

Viz také

• Zrušení