Stream.DisposeAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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メソッドを使用すると、メイン スレッドをブロックすることなく、リソースを大量に消費する破棄操作を実行できます。 このパフォーマンスに関する考慮事項は、時間のかかるストリーム操作によって UI スレッドがブロックされ、アプリが動作していないと見なされる可能性がある Windows 8.x Store アプリまたはデスクトップ アプリで特に重要です。 非同期メソッドは、Visual Basic および C# の および await
キーワードと組み合わせてasync
使用されます。
このメソッドは、バッキング ストアに変更を書き込み、ストリームを閉じてリソースを解放することでストリームを破棄します。
を呼び出 DisposeAsync
すと、 によって Stream 使用されるリソースを他の目的で再割り当てできます。 詳細については、「 アンマネージド リソースのクリーンアップ」を参照してください。
このメソッドは、メソッドの同期例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機されたときにスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって Dispose()スローされる例外に関するページを参照してください。
適用対象
.NET