SafeHandle.Dispose Método

Definição

Namespace:
System.Runtime.InteropServices
Assemblies:
mscorlib.dll, System.Runtime.Handles.dll
Assembly:
mscorlib.dll
Assembly:
System.Runtime.InteropServices.dll
Assembly:
System.Runtime.Handles.dll
Assembly:
netstandard.dll

Libera os recursos usados pela SafeHandle classe.

Sobrecargas

Nome Description
Dispose()

Libera todos os recursos usados pela SafeHandle classe.
Dispose(Boolean)

Libera os recursos não gerenciados usados pela SafeHandle classe especificando se uma operação de descarte normal deve ser executada.

Dispose()

Libera todos os recursos usados pela SafeHandle classe.

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 arquivos ou gravar alguns dados de volta na memória). Nesse caso, eles podem fornecer um finalizador que é garantido para 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.

Note

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)

Libera os recursos não gerenciados usados pela SafeHandle classe especificando se uma operação de descarte normal deve ser executada.

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.

Aplica-se a