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」を参照してください。

注釈

単一インスタンス カウンター セットの場合は 1 回、複数インスタンス カウンター セットの場合は 1 回以上このメソッドを呼び出します。

プロバイダーは、インスタンスを作成するタイミングを決定します。 カウンター データの方が静的な場合、プロバイダーは初期化時にインスタンスを作成できます。 たとえば、コンピューター上のプロセッサの数は静的と見なされるため、プロセッサのカウンター データを提供するプロバイダーは、初期化時にコンピューター上の各プロセッサのインスタンスを作成できます。 ディスク カウンターやプロセス カウンターなど、より動的なカウンターの場合、プロバイダーは、追加される新しい USB デバイスまたは新しいプロセスの作成に応答して、新しいインスタンスを作成します。

プロバイダーは、カウンター データを常に最新の状態に保つ必要があります。