SafeHandle.Dispose Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
.