PerformanceCounter.RemoveInstance 方法

定義

命名空間:

System.Diagnostics

組件:

System.Diagnostics.PerformanceCounter.dll

套件:

System.Diagnostics.PerformanceCounter v8.0.0

來源:

PerformanceCounter.cs

刪除由 PerformanceCounter 物件 InstanceName 屬性所指定的分類執行個體。

public:
 void RemoveInstance();

public void RemoveInstance ();

member this.RemoveInstance : unit -> unit

Public Sub RemoveInstance ()

例外狀況

InvalidOperationException

這個計數器是唯讀的，所以任何與分類相關的執行個體都無法移除。

-或-

該執行個體沒有與效能計數器正確的相關聯。

-或-

使用全域共用記憶體時，InstanceLifetime 屬性是設定為 Process。

Win32Exception

存取系統 API 時發生的錯誤。

備註

您只能移除自訂計數器的實例。 所有系統計數器都是只讀的，因此嘗試移除其中一個計數器會擲回例外狀況。

注意

若要避免在釋放性能計數器共用記憶體時可能發生的競爭狀況，建議 RemoveInstance 從 DomainUnload 事件處理程式呼叫 方法。

若要建立效能類別實例，請在建構函式上PerformanceCounter指定 instanceName 。 如果 指定的 instanceName 類別實例已經存在，新的物件將會參考現有的類別實例。

注意

如果 屬性的值InstanceLifetime是 Process ，而且使用 1.0 或 1.1 版 .NET Framework 建立性能計數器類別，InvalidOperationException則會擲回 。 使用舊版建立的效能計數器類別會使用全域共用記憶體，且的值 InstanceLifetime 必須是 Global。 如果 .NET Framework 1.0 或 1.1 版上執行的應用程式未使用此類別，請刪除並重新建立類別。