Stream.DisposeAsync 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

來源:

Stream.cs

以非同步方式釋放 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

傳回

ValueTask

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

實作

DisposeAsync()

備註

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

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

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

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