FileStream.FlushAsync(CancellationToken) Metode

Definisi

Ruang nama:

System.IO

Rakitan:

netstandard.dll, System.Runtime.dll

Sumber:

FileStream.cs

Secara asinkron menghapus semua buffer untuk aliran ini, menyebabkan data yang di-buffer ditulis ke file, dan memantau permintaan pembatalan.

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

Parameter

cancellationToken

CancellationToken

Token yang akan dipantau untuk permintaan pembatalan.

Mengembalikan

Task

Tugas yang mewakili operasi flush asinkron.

Pengecualian

ObjectDisposedException

Aliran telah dibuang.

OperationCanceledException

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Keterangan

Metode ini menghapus buffer aliran .NET ke file, tetapi tidak menghapus buffer file perantara dalam sistem operasi. Untuk memastikan bahwa semua data buffer ditulis ke perangkat penyimpanan yang mendasar, gunakan Flush(Boolean) metode dengan parameter yang flushToDisk diatur ke true.

Jika operasi dibatalkan sebelum selesai, tugas yang dikembalikan berisi Canceled nilai untuk Status properti . Jika handel ke file dibuang, tugas yang dikembalikan berisi ObjectDisposedException pengecualian dalam Exception properti .

Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh Flush().

Lihat juga

• Pembatalan