共用方式為


Stream.DisposeAsync 方法

定義

以非同步方式釋放 Stream 使用的不受控資源。

public:
 virtual System::Threading::Tasks::ValueTask DisposeAsync();
public virtual System.Threading.Tasks.ValueTask DisposeAsync ();
abstract member DisposeAsync : unit -> System.Threading.Tasks.ValueTask
override this.DisposeAsync : unit -> System.Threading.Tasks.ValueTask
Public Overridable Function DisposeAsync () As ValueTask

傳回

代表非同步處署作業的工作。

實作

備註

方法 DisposeAsync 可讓您執行需要大量資源的處置作業,而不會封鎖主線程。 這項效能考量對於 Windows 8.x Store 應用程式或傳統型應用程式而言特別重要,尤其是針對耗時的資料流作業可能會阻礙 UI 執行緒,使應用程式看起來像是停止運作的情況。 異步方法會與 async Visual Basic 和 C# 中的 和 await 關鍵詞搭配使用。

這個方法會將任何變更寫入備份存放區,並關閉數據流以釋放資源,以處置數據流。

呼叫 DisposeAsync 可讓 重新配置 所使用的 Stream 資源供其他用途使用。 如需詳細資訊,請參閱 清除非受控資源

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

適用於