CounterSet.CreateCounterSetInstance(String) CounterSet.CreateCounterSetInstance(String) CounterSet.CreateCounterSetInstance(String) CounterSet.CreateCounterSetInstance(String) Method

定義

カウンター セットのインスタンスを作成します。Creates an instance of the counter set.

public:
 System::Diagnostics::PerformanceData::CounterSetInstance ^ CreateCounterSetInstance(System::String ^ instanceName);
[System.Security.SecurityCritical]
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 String String String

インスタンスの名前。Name of the instance. この名前は一意である必要があります。The name must be unique.

戻り値

カウンター データを格納するカウンター セットのインスタンス。An instance of the counter set which will contain the counter data.

例外

インスタンス名が NULL です。The instance name is NULL.

カウンター セットのインスタンスを作成する前に、カウンター セットにカウンターを追加する必要があります。You must add counters to the counter set before creating an instance of the counter set.

例については、「System.Diagnostics.PerformanceData」を参照してください。For an example, see System.Diagnostics.PerformanceData.

注釈

このメソッドは、単一インスタンスのカウンターセットに対して1回、または複数インスタンスのカウンターセットに対して1回以上呼び出すことができます。Call this method one time for single-instance counter sets and one or more times for multiple-instance counter sets.

プロバイダーは、インスタンスをいつ作成するかを決定します。The provider determines when it creates an instance. カウンターデータが静的である場合、プロバイダーは初期化時にインスタンスを作成できます。If the counter data is more static, the provider can create an instance at initialization time. たとえば、コンピューターのプロセッサの数は静的と見なされるため、プロセッサのカウンターデータを提供するプロバイダーは、初期化時にコンピューター上の各プロセッサに対してインスタンスを作成できます。For example, the number of processors on a computer would be considered static, so a provider that provides counter data for processors could create an instance for each processor on the computer at initialization time. ディスクカウンターやプロセスカウンターなど、より動的なカウンターの場合、プロバイダーは新しい USB デバイスの追加または新しいプロセスの作成に応じて新しいインスタンスを作成します。For counters that are more dynamic, such as disk or process counters, the providers would create the new instances in response to a new USB device being added or a new process being created.

プロバイダーは、常にカウンターデータを最新の状態に保つ必要があります。The provider should keep the counter data up-to-date at all times.

適用対象