SafeHandle.Dispose Método

Definição

Namespace:

System.Runtime.InteropServices

Assemblies:

mscorlib.dll, System.Runtime.Handles.dll

Assembly:

System.Runtime.dll

Assembly:

System.Runtime.Handles.dll

Assembly:

mscorlib.dll

Assembly:

System.Runtime.InteropServices.dll

Assembly:

netstandard.dll

Libera os recursos usados pela classe SafeHandle.

Sobrecargas

Dispose()	Libera todos os recursos usados pela classe SafeHandle.
Dispose(Boolean)	Libera os recursos não gerenciados usados pela classe SafeHandle que especifica se deve executar uma operação de descarte normal.

Dispose()

Libera todos os recursos usados pela classe SafeHandle.

public:
 virtual void Dispose();

public void Dispose ();

abstract member Dispose : unit -> unit
override this.Dispose : unit -> unit

Public Sub Dispose ()

Implementações

Dispose()

Comentários

Chamar o Close método ou Dispose permite que os recursos sejam liberados. Isso pode não acontecer imediatamente se outros threads estiverem usando a mesma instância do identificador seguro, mas ocorrerá assim que esse não for mais o caso. Embora a maioria das classes que usam SafeHandle não precise fornecer um finalizador, isso às vezes é necessário (por exemplo, para liberar buffers de arquivo ou gravar alguns dados de volta na memória). Nesse caso, eles podem fornecer um finalizador que tem a garantia de ser executado antes da execução do SafeHandle finalizador crítico.

Chame o Close método ou Dispose quando terminar de usar o SafeHandle objeto. O Close método deixa o SafeHandle objeto em um estado inutilizável.

Observação

Sempre chame o Close método ou Dispose o método antes de liberar sua última referência ao SafeHandle objeto. Caso contrário, os recursos que ele está usando não serão liberados até que o coletor de lixo chame o SafeHandle método do Finalize objeto.

Dispose(Boolean)

Libera os recursos não gerenciados usados pela classe SafeHandle que especifica se deve executar uma operação de descarte normal.

protected:
 virtual void Dispose(bool disposing);

[System.Security.SecurityCritical]
protected virtual void Dispose (bool disposing);

protected virtual void Dispose (bool disposing);

[<System.Security.SecurityCritical>]
abstract member Dispose : bool -> unit
override this.Dispose : bool -> unit

abstract member Dispose : bool -> unit
override this.Dispose : bool -> unit

Protected Overridable Sub Dispose (disposing As Boolean)

Parâmetros

disposing

Boolean

true para uma operação de descarte normal, false para finalizar o identificador.

Atributos

SecurityCriticalAttribute

Comentários

Você nunca deve chamar explicitamente o Dispose método com o disposing parâmetro definido como false.