System.IO.Stream.Dispose 方法 (Boolean)

方法描述

释放由 Stream 占用的非托管资源,还可以另外再释放托管资源。

语法定义(C# System.IO.Stream.Dispose 方法 (Boolean) 的用法)

protected virtual void Dispose(
	bool disposing
)

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
disposing System-Boolean 为 true,则释放托管资源和非托管资源;为 false,则仅释放非托管资源。
返回值 void

提示和注释

您应通过为 disposing 指定 true 释放所有资源。 当 disposing 为 true 时,流也可以确保将数据刷新至基础缓冲区,并访问其他可终结对象。 当由于终结器中缺少排序而从终结器调用时这不太可能。

如果流使用操作系统句柄与其资源通信,请考虑使用 SafeHandle 的子类用于此用途。

此方法由公共的 Dispose 方法和 Finalize 方法调用。 Dispose 调用受保护的 Dispose 方法,该方法的 disposing 参数设置为 true。 Finalize 调用 disposing 设置为 false 的 Dispose。

对继承者的说明

在派生类中不要重写 Close 方法,而应将所有流清理逻辑放入 Dispose 方法中。

Dispose 可以由其他对象多次调用。 重写 Dispose 时,请注意不要引用在以前调用 Dispose 时已释放的对象。 有关如何实现 Dispose 的更多信息,请参见 实现 Dispose 方法。

有关 Dispose 和 Finalize 的更多信息,请参见 清理非托管资源 和 重写 Finalize 方法。

System.IO.Stream.Dispose 方法 (Boolean)例子


异常

异常 异常描述

命名空间

namespace: System.IO

程序集: mscorlib(在 mscorlib.dll 中)

版本信息

.NET Framework 受以下版本支持:4、3.5、3.0、2.0 .NET Framework Client Profile 受以下版本支持:4、3.5 SP1 受以下版本支持:

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。