CriticalHandle.Dispose Metodo

Definizione

Contrassegna l'handle per il rilascio delle risorse.

Overload

Dispose()

Rilascia tutte le risorse usate da CriticalHandle.

Dispose(Boolean)

Rilascia le risorse non gestite usate dalla classe CriticalHandle specificando se eseguire una normale operazione di eliminazione.

Dispose()

Origine:
CriticalHandle.cs
Origine:
CriticalHandle.cs
Origine:
CriticalHandle.cs

Rilascia tutte le risorse usate da CriticalHandle.

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

Implementazioni

Commenti

La chiamata al Close metodo o Dispose consente di liberare le risorse. A differenza della SafeHandle classe, questa operazione verrà sempre eseguita immediatamente perché non esiste alcun conteggio di riferimenti per indicare che altri thread usano questo handle. Pertanto, è necessario usare un meccanismo di sincronizzazione per assicurarsi che sia sicuro chiamare il Dispose metodo. Anche se la maggior parte delle classi che usano la CriticalHandle classe non deve fornire un finalizzatore, questo è talvolta necessario (ad esempio, per scaricare i buffer di file o per scrivere alcuni dati in memoria). In questo caso, la classe può fornire un finalizzatore garantito per l'esecuzione prima dell'esecuzione del CriticalHandle finalizzatore critico.

Chiamare il metodo o Dispose al termine dell'uso Close dell'oggettoCriticalHandle. Il Close metodo lascia l'oggetto CriticalHandle in uno stato inutilizzabile.

Nota Chiamare sempre il metodo o Dispose prima di rilasciare l'ultimo Close riferimento all'oggettoCriticalHandle. In caso contrario, le risorse utilizzate non verranno liberate finché il metodo CriticalHandle dell'oggetto Finalize non viene richiamato dal Garbage Collector.

Si applica a

Dispose(Boolean)

Origine:
CriticalHandle.cs
Origine:
CriticalHandle.cs
Origine:
CriticalHandle.cs

Rilascia le risorse non gestite usate dalla classe CriticalHandle specificando se eseguire una normale operazione di eliminazione.

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)

Parametri

disposing
Boolean

true per una normale operazione di eliminazione; false per finalizzare l'handle.

Attributi

Commenti

Non è mai necessario chiamare in modo esplicito il metodo con il Disposedisposing parametro impostato su false.

Si applica a