Component.Dispose Método
Definición
Sobrecargas
Dispose() |
Libera todos los recursos que usa Component.Releases all resources used by the Component. |
Dispose(Boolean) |
Libera los recursos no administrados que usa Component y, de forma opcional, libera los recursos administrados.Releases the unmanaged resources used by the Component and optionally releases the managed resources. |
Dispose()
public:
virtual void Dispose();
public void Dispose ();
abstract member Dispose : unit -> unit
override this.Dispose : unit -> unit
Public Sub Dispose ()
Implementaciones
Comentarios
Llame a Dispose cuando haya terminado de usar Component.Call Dispose when you are finished using the Component. El método Dispose deja el Component en un estado no utilizable.The Dispose method leaves the Component in an unusable state. Después de llamar a Dispose , debe liberar todas las referencias a para Component que el recolector de elementos no utilizados pueda reclamar la memoria que Component ocupaba.After calling Dispose, you must release all references to the Component so the garbage collector can reclaim the memory that the Component was occupying. Para obtener más información, vea limpiar recursos no administrados e implementar un método Dispose.For more information, see Cleaning Up Unmanaged Resources and Implementing a Dispose Method.
Nota
Realice siempre una llamada a Dispose antes de liberar la última referencia al objeto Component.Always call Dispose before you release your last reference to the Component. En caso contrario, los recursos que está usando no se liberarán hasta que el recolector de elementos no utilizados llame al método Component del objeto Finalize
.Otherwise, the resources it is using will not be freed until the garbage collector calls the Component object's Finalize
method.
Consulte también
Se aplica a
Dispose(Boolean)
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)
Parámetros
- disposing
- Boolean
Es true
para liberar tanto recursos administrados como no administrados; es false
para liberar únicamente recursos no administrados.true
to release both managed and unmanaged resources; false
to release only unmanaged resources.
Comentarios
El método público Dispose y el método llaman a este método Finalize .This method is called by the public Dispose method and the Finalize method. Dispose()
invoca el método protegido Dispose(Boolean)
con el disposing
parámetro establecido en true
.Dispose()
invokes the protected Dispose(Boolean)
method with the disposing
parameter set to true
. Finalize invoca Dispose
con disposing
establecido en false
.Finalize invokes Dispose
with disposing
set to false
.
Cuando el parámetro disposing
es true
, este método libera todos los recursos retenidos por los objetos administrados a los que el control Component hace referencia.When the disposing
parameter is true
, this method releases all resources held by any managed objects that this Component references. Este método invoca al método Dispose()
de cada uno de los objetos a los que se hace referencia.This method invokes the Dispose()
method of each referenced object.
Notas a los desarrolladores de herederos
Dispose
puede recibir varias llamadas de otros objetos.
Dispose
can be called multiple times by other objects. Al invalidar Dispose(Boolean)
, tenga cuidado de no hacer referencia a objetos que se hayan eliminado en una llamada anterior a Dispose
.When overriding Dispose(Boolean)
, be careful not to reference objects that have been previously disposed of in an earlier call to Dispose
. Para obtener más información sobre cómo implementar Dispose(Boolean)
, vea [implementar un método Dispose](/dotnet/standard/garbage-collection/implementing-dispose).For more information about how to implement Dispose(Boolean)
, see [Implementing a Dispose Method](/dotnet/standard/garbage-collection/implementing-dispose).
Para obtener más información sobre Dispose
y Finalize() , vea limpiar recursos no administrados e invalidar el método Finalize.For more information about Dispose
and Finalize(), see Cleaning Up Unmanaged Resources and Overriding the Finalize Method.