CounterSet.CreateCounterSetInstance(String) 方法

定義

命名空間:

System.Diagnostics.PerformanceData

組件:

System.Diagnostics.PerformanceCounter.dll

套件:

System.Diagnostics.PerformanceCounter v8.0.0

來源:

CounterSet.cs

建立計數器集合的執行個體。

public:
 System::Diagnostics::PerformanceData::CounterSetInstance ^ CreateCounterSetInstance(System::String ^ instanceName);

public System.Diagnostics.PerformanceData.CounterSetInstance CreateCounterSetInstance (string instanceName);

member this.CreateCounterSetInstance : string -> System.Diagnostics.PerformanceData.CounterSetInstance

Public Function CreateCounterSetInstance (instanceName As String) As CounterSetInstance

參數

instanceName

String

執行個體的名稱。 名稱必須是唯一的。

傳回

CounterSetInstance

包含計數器資料之計數器集合的執行個體。

例外狀況

ArgumentException

執行個體名稱是 NULL。

InvalidOperationException

您必須在建立計數器集合的執行個體前，將計數器加入至計數器集合中。

範例

如需範例，請參閱 System.Diagnostics.PerformanceData。

備註

針對單一實例計數器集合呼叫這個方法一次，針對多個實例計數器集呼叫一次或多次。

提供者會決定何時建立實例。 如果計數器數據更靜態，提供者可以在初始化時建立實例。 例如，計算機上的處理器數目會被視為靜態，因此提供處理器計數器數據的提供者可以在初始化時為計算機上的每個處理器建立實例。 對於更動態的計數器，例如磁碟或進程計數器，提供者會建立新的實例，以回應新增的USB裝置或正在建立的新進程。

提供者應該隨時讓計數器數據保持最新狀態。