SafeHandle.Dispose Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Rilascia le risorse usate dalla classe SafeHandle.
Overload
Dispose() |
Rilascia tutte le risorse usate dalla classe SafeHandle. |
Dispose(Boolean) |
Rilascia le risorse non gestite usate dalla classe SafeHandle specificando se eseguire una normale operazione di eliminazione. |
Dispose()
- Origine:
- SafeHandle.cs
- Origine:
- SafeHandle.cs
- Origine:
- SafeHandle.cs
Rilascia tutte le risorse usate dalla classe SafeHandle.
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. Ciò potrebbe non verificarsi immediatamente se altri thread usano la stessa istanza dell'handle sicuro, ma si verificheranno non appena questo non è più il caso. Anche se la maggior parte delle classi che usano SafeHandle non devono fornire un finalizzatore, questo è talvolta necessario (ad esempio, scaricare i buffer di file o scrivere alcuni dati in memoria). In questo caso, possono fornire un finalizzatore garantito per l'esecuzione prima dell'esecuzione del SafeHandle finalizzatore critico.
Chiamare il metodo o Dispose al termine dell'uso Close dell'oggettoSafeHandle. Il Close metodo lascia l'oggetto SafeHandle in uno stato inutilizzabile.
Nota
Chiamare sempre il metodo o Dispose prima di rilasciare l'ultimo Close riferimento all'oggettoSafeHandle. In caso contrario, le risorse utilizzate non verranno liberate finché il metodo SafeHandle dell'oggetto Finalize non viene richiamato dal Garbage Collector.
Si applica a
Dispose(Boolean)
- Origine:
- SafeHandle.cs
- Origine:
- SafeHandle.cs
- Origine:
- SafeHandle.cs
Rilascia le risorse non gestite usate dalla classe SafeHandle 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
.