CriticalHandle.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.
Marca o identificador de liberação de recursos.
Sobrecargas
Dispose() |
Libera todos os recursos usados pelo CriticalHandle. |
Dispose(Boolean) |
Libera os recursos não gerenciados usados pela classe CriticalHandle que especifica se deve executar uma operação de descarte normal. |
Dispose()
- Origem:
- CriticalHandle.cs
- Origem:
- CriticalHandle.cs
- Origem:
- CriticalHandle.cs
Libera todos os recursos usados pelo CriticalHandle.
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. Ao contrário da SafeHandle classe , isso sempre acontecerá imediatamente, pois não há nenhuma contagem de referência para indicar que outros threads estão usando esse identificador. Portanto, você deve empregar um mecanismo de sincronização para garantir que seja seguro chamar o Dispose método. Embora a maioria das classes que usam a CriticalHandle classe não precise fornecer um finalizador, isso às vezes é necessário (por exemplo, para liberar buffers de arquivo ou gravar alguns dados novamente na memória). Nesse caso, a classe pode fornecer um finalizador que tem a garantia de ser executado antes que o CriticalHandle finalizador crítico seja executado.
Chame o Close método ou Dispose quando terminar de usar o CriticalHandle objeto . O Close método deixa o CriticalHandle objeto em um estado inutilizável.
Nota Sempre chame o Close método ou Dispose antes de liberar sua última referência ao CriticalHandle objeto . Caso contrário, os recursos que ele está usando não serão liberados até que o coletor de lixo chame o CriticalHandle método do Finalize objeto.
Aplica-se a
Dispose(Boolean)
- Origem:
- CriticalHandle.cs
- Origem:
- CriticalHandle.cs
- Origem:
- CriticalHandle.cs
Libera os recursos não gerenciados usados pela classe CriticalHandle 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
.