Stream.FlushAsync 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

以非同步的方式清除這個資料流的所有緩衝區，並造成所有緩衝資料都寫入基礎裝置。

多載

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

FlushAsync()

來源:

Stream.cs

以非同步的方式清除這個資料流的所有緩衝區，並造成所有緩衝資料都寫入基礎裝置。

public:
 System::Threading::Tasks::Task ^ FlushAsync();

public System.Threading.Tasks.Task FlushAsync ();

member this.FlushAsync : unit -> System.Threading.Tasks.Task

Public Function FlushAsync () As Task

傳回

Task

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

例外狀況

ObjectDisposedException

資料流已經處置。

備註

如果 衍生類別，例如 DeflateStream 或 GZipStream ，不會在 方法的實作 Flush 中排清緩衝區， FlushAsync 則方法不會排清緩衝區。

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

FlushAsync(CancellationToken)

來源:

Stream.cs

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

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

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

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

Public Overridable Function FlushAsync (cancellationToken As CancellationToken) As Task

參數

cancellationToken

CancellationToken

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

傳回

Task

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

例外狀況

ObjectDisposedException

資料流已經處置。

OperationCanceledException

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

備註

如果作業在完成之前取消，則傳回的工作會 Canceled 包含 屬性的值 Status 。

如果 衍生類別，例如 DeflateStream 或 GZipStream ，不會在 方法的實作 Flush 中排清緩衝區， FlushAsync 則方法不會排清緩衝區。

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

另請參閱

• 取消