Compartilhar via


SafeHandle.Dispose Método

Definição

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()

Origem:
SafeHandle.cs
Origem:
SafeHandle.cs
Origem:
SafeHandle.cs

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

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 que o SafeHandle finalizador crítico seja executado.

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 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.

Aplica-se a

Dispose(Boolean)

Origem:
SafeHandle.cs
Origem:
SafeHandle.cs
Origem:
SafeHandle.cs

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

Comentários

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

Aplica-se a