SafeHandle.Dispose Método

Definição

Espaço de Nomes:
System.Runtime.InteropServices
Assemblagens:
mscorlib.dll, System.Runtime.Handles.dll
Assemblagem:
mscorlib.dll
Assemblagem:
System.Runtime.InteropServices.dll
Assemblagem:
System.Runtime.Handles.dll
Assemblagem:
netstandard.dll

Liberta os recursos usados pela SafeHandle turma.

Sobrecargas

Name Description
Dispose()

Liberta todos os recursos usados pela SafeHandle turma.
Dispose(Boolean)

Liberta os recursos não geridos usados pela SafeHandle classe especificando se deve realizar uma operação normal de eliminação.

Dispose()

Liberta todos os recursos usados pela SafeHandle turma.

public:
 virtual void Dispose();
public void Dispose();
abstract member Dispose : unit -> unit
override this.Dispose : unit -> unit
Public Sub Dispose ()

Implementações

Dispose()

Observações

Chamar o Close método ou Dispose permite libertar os recursos. Isto pode não acontecer imediatamente se outros threads estiverem a usar a mesma instância do safe handle, mas acontecerá assim que isso deixar de acontecer. Embora a maioria das classes que usam SafeHandle não precise de fornecer um finalizador, isto por vezes é necessário (por exemplo, para limpar buffers de ficheiros ou para reescrever alguns dados na memória). Neste caso, podem fornecer um finalizador que garante a execução antes do SafeHandle finalizador crítico executar.

Chame o Close método ou Dispose quando terminar de usar o SafeHandle objeto. O Close método deixa o SafeHandle objeto num estado inutilizável.

Note

Ligue sempre para o Close método ou Dispose antes de divulgar a última referência ao SafeHandle objeto. Caso contrário, os recursos que está a usar não serão libertados até que o coletor de lixo chame o SafeHandle método do Finalize objeto.

Aplica-se a

Dispose(Boolean)

Liberta os recursos não geridos usados pela SafeHandle classe especificando se deve realizar uma operação normal de eliminação.

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 normal de eliminação; false para finalizar o cabo.

Atributos
SecurityCriticalAttribute

Observações

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

Aplica-se a