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メソッドを使用すると、メイン スレッドをブロックすることなく、リソースを大量に消費する破棄操作を実行できます。 このパフォーマンスに関する考慮事項は、時間のかかるストリーム操作によって UI スレッドがブロックされ、アプリが動作していないと見なされる可能性がある Windows 8.x Store アプリまたはデスクトップ アプリで特に重要です。 非同期メソッドは、Visual Basic および C# の および await キーワードと組み合わせてasync使用されます。

このメソッドは、バッキング ストアに変更を書き込み、ストリームを閉じてリソースを解放することでストリームを破棄します。

を呼び出 DisposeAsync すと、 によって Stream 使用されるリソースを他の目的で再割り当てできます。 詳細については、「 アンマネージド リソースのクリーンアップ」を参照してください。

このメソッドは、メソッドの同期例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機されたときにスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって Dispose()スローされる例外に関するページを参照してください。