Component.Dispose Component.Dispose Component.Dispose Component.Dispose Method

定义

释放由 Component 占用的资源。Releases the resources used by the Component.

重载

Dispose() Dispose() Dispose() Dispose()

释放由 Component 使用的所有资源。Releases all resources used by the Component.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

释放由 Component 占用的非托管资源,还可以另外再释放托管资源。Releases the unmanaged resources used by the Component and optionally releases the managed resources.

Dispose() Dispose() Dispose() Dispose()

释放由 Component 使用的所有资源。Releases all resources used by the Component.

public:
 virtual void Dispose();
public void Dispose ();
abstract member Dispose : unit -> unit
override this.Dispose : unit -> unit
Public Sub Dispose ()

实现

注解

在完成使用 Dispose 后,应调用 ComponentCall Dispose when you are finished using the Component. Dispose 方法使 Component 处于不可用状态。The Dispose method leaves the Component in an unusable state. 调用Dispose后, 必须释放对的Component所有引用, 以便垃圾回收器能够Component回收占用的内存。After calling Dispose, you must release all references to the Component so the garbage collector can reclaim the memory that the Component was occupying. 有关详细信息, 请参阅清理非托管资源实现 Dispose 方法For more information, see Cleaning Up Unmanaged Resources and Implementing a Dispose Method.

备注

每次释放对 Dispose 的最后一个引用前,均应调用 ComponentAlways call Dispose before you release your last reference to the Component. 否则,在垃圾回收器调用 Component 对象的 Finalize 方法之前,该对象正在使用的资源不会被释放。Otherwise, the resources it is using will not be freed until the garbage collector calls the Component object's Finalize method.

另请参阅

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

释放由 Component 占用的非托管资源,还可以另外再释放托管资源。Releases the unmanaged resources used by the Component and optionally releases the managed resources.

protected:
 virtual void Dispose(bool disposing);
protected virtual void Dispose (bool disposing);
abstract member Dispose : bool -> unit
override this.Dispose : bool -> unit
Protected Overridable Sub Dispose (disposing As Boolean)

参数

disposing
Boolean Boolean Boolean Boolean

若要释放托管资源和非托管资源,则为 true;若仅释放非托管资源,则为 falsetrue to release both managed and unmanaged resources; false to release only unmanaged resources.

注解

此方法由公共Dispose方法Finalize和方法调用。This method is called by the public Dispose method and the Finalize method. Dispose()调用受保护Dispose(Boolean)的方法, disposing并将参数true设置为。Dispose() invokes the protected Dispose(Boolean) method with the disposing parameter set to true. FinalizeDispose 设置disposingfalse的情况调用。Finalize invokes Dispose with disposing set to false.

disposing 参数为 true 时,此方法释放该 Component 引用的、由任何托管对象持有的全部资源。When the disposing parameter is true, this method releases all resources held by any managed objects that this Component references. 此方法调用每个引用对象的 Dispose() 方法。This method invokes the Dispose() method of each referenced object.

继承者说明

Dispose 可以由其他对象多次调用。 Dispose can be called multiple times by other objects. 重写 Dispose(Boolean) 时,请注意不要引用在以前调用 Dispose 时已释放的对象。When overriding Dispose(Boolean), be careful not to reference objects that have been previously disposed of in an earlier call to Dispose. 有关如何实现Dispose(Boolean)的详细信息, 请参阅[实现 Dispose 方法](~/docs/standard/garbage-collection/implementing-dispose.md)。For more information about how to implement Dispose(Boolean), see [Implementing a Dispose Method](~/docs/standard/garbage-collection/implementing-dispose.md). 有关DisposeFinalize()的详细信息, 请参阅[清理非托管资源](~/docs/standard/garbage-collection/unmanaged.md)和[重写 Finalize 方法](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/ddae83kx(v=vs.100))。For more information about Dispose and Finalize(), see [Cleaning Up Unmanaged Resources](~/docs/standard/garbage-collection/unmanaged.md) and [Overriding the Finalize Method](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/ddae83kx(v=vs.100)).

适用于