FileStream.FlushAsync(CancellationToken) 方法

定義

以非同步的方式清除這個資料流的所有緩衝區,造成所有緩衝資料都寫入基礎裝置,並且監視取消要求。

public override System.Threading.Tasks.Task FlushAsync (System.Threading.CancellationToken cancellationToken);
[System.Runtime.InteropServices.ComVisible(false)]
public override System.Threading.Tasks.Task FlushAsync (System.Threading.CancellationToken cancellationToken);

參數

cancellationToken
CancellationToken

用來監視是否有取消要求的語彙基元。

傳回

表示非同步排清作業的工作。

屬性

例外狀況

資料流已經處置。

取消令牌已取消。 此例外狀況會儲存在傳回的工作中。

備註

如果作業在完成之前取消,則傳回的工作會 Canceled 包含 屬性的值 Status 。 如果處置檔案的句柄,傳回的工作會在 ObjectDisposedException 屬性中包含 Exception 例外狀況。

這個方法會儲存在工作中,它會傳回方法同步對應專案可以擲回的所有非使用狀況例外狀況。 如果例外狀況儲存在傳回的工作中,則會在等候工作時擲回該例外狀況。 使用狀況例外狀況,例如 ArgumentException,仍會同步擲回。 如需預存的例外狀況,請參閱 所 Flush()擲回的例外狀況。

適用於

產品 版本
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

另請參閱