SafeHandle.Dispose SafeHandle.Dispose SafeHandle.Dispose SafeHandle.Dispose Method

Definición

Libera los recursos que usa la clase SafeHandle.Releases the resources used by the SafeHandle class.

Sobrecargas

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

Libera todos los recursos que utiliza la clase SafeHandle.Releases all resources used by the SafeHandle class.

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

Libera los recursos no administrados utilizados por la clase SafeHandle que especifica si se va a realizar una operación de desecho normal.Releases the unmanaged resources used by the SafeHandle class specifying whether to perform a normal dispose operation.

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

Libera todos los recursos que utiliza la clase SafeHandle.Releases all resources used by the SafeHandle class.

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

Implementaciones

Comentarios

La llamada al Dispose método opermiteliberarlosrecursos.CloseCalling the Close or Dispose method allows the resources to be freed. Es posible que esto no suceda inmediatamente si otros subprocesos usan la misma instancia del controlador seguro, pero se producirán tan pronto como ya no sea el caso.This might not happen immediately if other threads are using the same instance of the safe handle, but will happen as soon as that is no longer the case. Aunque la mayoría de SafeHandle las clases que usan no necesitan proporcionar un finalizador, a veces es necesario (por ejemplo, para vaciar los búferes de archivo o escribir algunos datos en la memoria).Although most classes using SafeHandle do not need to provide a finalizer, this is sometimes necessary (for example, to flush out file buffers or to write some data back into memory). En este caso, pueden proporcionar un finalizador que se garantiza que se ejecute antes de SafeHandle que se ejecute el finalizador crítico.In this case, they can provide a finalizer that is guaranteed to run before the SafeHandle critical finalizer runs.

Llame al método Dispose SafeHandle o cuando termine de utilizar el objeto. CloseCall the Close or Dispose method when you are finished using the SafeHandle object. El Close método deja el SafeHandle objeto en un estado inutilizable.The Close method leaves the SafeHandle object in an unusable state.

Nota

Llame siempre al Close método Dispose o antes de liberar la última referencia al SafeHandle objeto.Always call the Close or Dispose method before you release your last reference to the SafeHandle object. En caso contrario, los recursos que está usando no se liberarán hasta que el recolector de elementos no utilizados llame al método SafeHandle del objeto Finalize.Otherwise, the resources it is using will not be freed until the garbage collector calls the SafeHandle object's Finalize method.

Seguridad

SecurityPermission
para obtener permiso para llamar a código no administrado.for permission to call unmanaged code. Acción de seguridad LinkDemand:.Security action: LinkDemand. Enumeración asociada:UnmanagedCodeAssociated enumeration: UnmanagedCode

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

Libera los recursos no administrados utilizados por la clase SafeHandle que especifica si se va a realizar una operación de desecho normal.Releases the unmanaged resources used by the SafeHandle class specifying whether to perform a normal dispose operation.

protected:
 virtual void Dispose(bool disposing);
[System.Security.SecurityCritical]
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 Boolean Boolean Boolean

true para una operación de desecho normal; false para finalizar el identificador.true for a normal dispose operation; false to finalize the handle.

Comentarios

Nunca debe llamar explícitamente al Dispose método con el disposing parámetro establecido en false.You should never explicitly call the Dispose method with the disposing parameter set to false.

Seguridad

SecurityPermission
para obtener permiso para llamar a código no administrado.for permission to call unmanaged code. Acción de seguridad LinkDemand:.Security action: LinkDemand. Enumeración asociada:UnmanagedCodeAssociated enumeration: UnmanagedCode

Se aplica a