Stream.DisposeAsync メソッド


Stream によって使用されているアンマネージ リソースを非同期に解放します。Asynchronously releases the unmanaged resources used by the Stream.

 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



非同期の破棄操作を表すタスク。A task that represents the asynchronous dispose operation.



DisposeAsyncメソッドを使用すると、メインスレッドをブロックせずに、リソースを集中的に使用する dispose 操作を実行できます。The DisposeAsync method enables you to perform a resource-intensive dispose operation without blocking the main thread. このパフォーマンスに関する考慮事項は、時間のかかるストリーム操作によって UI スレッドがブロックされ、アプリが動作していないと見なされる可能性がある Windows 8.x ストアWindows 8.x Store アプリまたは デスクトップdesktop アプリで特に重要です。This performance consideration is particularly important in a Windows 8.x ストアWindows 8.x Store app or デスクトップdesktop app where a time-consuming stream operation can block the UI thread and make your app appear as if it is not working. 非同期メソッドは、 async Visual Basic および C# のキーワードとキーワードと組み合わせて使用され await ます。The async methods are used in conjunction with the async and await keywords in Visual Basic and C#.

このメソッドは、バッキングストアに変更を書き込んでストリームを破棄し、リソースを解放するためにストリームを閉じます。This method disposes the stream by writing any changes to the backing store and closing the stream to release resources.

を呼び出すと DisposeAsync 、によって使用されるリソース Stream を他の目的で再割り当てできます。Calling DisposeAsync allows the resources used by the Stream to be reallocated for other purposes. 詳細については、「 アンマネージリソースのクリーンアップ」を参照してください。For more information, see Cleaning Up Unmanaged Resources.