SafeHandle.Dispose 方法

定義

命名空間:

System.Runtime.InteropServices

組件:

System.Runtime.dll

釋放 SafeHandle 類別所使用的資源。

多載

Dispose()	釋放 SafeHandle 類別所使用的所有資源。
Dispose(Boolean)	釋放 SafeHandle 類別所使用的 Unmanaged 資源，指定是否要執行一般處置作業。

Dispose()

來源:

SafeHandle.cs

釋放 SafeHandle 類別所使用的所有資源。

public:
 virtual void Dispose();

public void Dispose ();

abstract member Dispose : unit -> unit
override this.Dispose : unit -> unit

Public Sub Dispose ()

實作

Dispose()

備註

Close呼叫 或 Dispose 方法可釋放資源。 如果其他線程使用相同的安全句柄實例，但一旦不再發生，就可能不會立即發生這種情況。 雖然大部分使用 SafeHandle 的類別不需要提供完成項，但有時需要 (來清除檔案緩衝區，或將某些數據寫回記憶體) 。 在此情況下，他們可以提供保證在重要完成項執行之前 SafeHandle 執行的完成項。

Close當您完成使用 物件時，SafeHandle請呼叫 或 Dispose 方法。 方法會將 CloseSafeHandle 物件保留為無法使用的狀態。

注意

在您釋放對象的最後一個參考SafeHandle之前，請一律呼叫 Close 或 Dispose 方法。 否則工作窗格所使用的資源不會釋放，直到記憶體回收行程呼叫 SafeHandle 物件的 Finalize 方法。

Dispose(Boolean)

來源:

SafeHandle.cs

釋放 SafeHandle 類別所使用的 Unmanaged 資源，指定是否要執行一般處置作業。

protected:
 virtual void Dispose(bool disposing);

protected virtual void Dispose (bool disposing);

abstract member Dispose : bool -> unit
override this.Dispose : bool -> unit

Protected Overridable Sub Dispose (disposing As Boolean)

參數

disposing

Boolean

true 表示一般處置作業，false 則表示結束控制代碼。

備註

您絕對不應該明確呼叫 方法，Disposedisposing並將 參數設定為 false。