Stream.FlushAsync 方法

定義

命名空間:

System.IO

組件:

netstandard.dll, System.Runtime.dll

非同步清除此串流的所有緩衝區，並使任何緩衝資料寫入底層裝置。

多載

名稱	Description
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()拋出的例外。

另請參閱

• 取消