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 -> unitPublic 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 -> unitabstract member Dispose : bool -> unit
override this.Dispose : bool -> unitProtected 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.
