Stream.DisposeAsync 方法

定义

异步释放由 <a0/a0> 使用的非托管资源。

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 应用商店应用或桌面应用中,这种性能注意事项尤其重要,其中耗时的流作可能会阻止 UI 线程,并使你的应用看起来好像不起作用一样。 异步方法与 Visual Basic 中的 async 和 C# 中的 await 关键字结合使用。

此方法通过将任何更改写入支持存储并关闭流来释放资源来释放流。

调用 DisposeAsync 后,Stream 的资源即可重新分配用于其他目的。 有关详细信息,请参阅 清理非托管资源

此方法存储在任务中,它返回该方法的同步对应项可以引发的所有非使用异常。 如果异常存储在返回的任务中,则等待任务时将引发该异常。 使用情况异常(例如 ArgumentException)仍会同步引发。 有关存储的异常,请参阅由 Dispose()..

适用于