Поделиться через


CounterSet.CreateCounterSetInstance(String) Метод

Определение

Создает экземпляр набора счетчиков.

public:
 System::Diagnostics::PerformanceData::CounterSetInstance ^ CreateCounterSetInstance(System::String ^ instanceName);
public System.Diagnostics.PerformanceData.CounterSetInstance CreateCounterSetInstance (string instanceName);
[System.Security.SecurityCritical]
public System.Diagnostics.PerformanceData.CounterSetInstance CreateCounterSetInstance (string instanceName);
member this.CreateCounterSetInstance : string -> System.Diagnostics.PerformanceData.CounterSetInstance
[<System.Security.SecurityCritical>]
member this.CreateCounterSetInstance : string -> System.Diagnostics.PerformanceData.CounterSetInstance
Public Function CreateCounterSetInstance (instanceName As String) As CounterSetInstance

Параметры

instanceName
String

Имя экземпляра. Имя должно быть уникальным.

Возвращаемое значение

Экземпляр набора счетчиков, в котором будут содержаться данные счетчиков.

Атрибуты

Исключения

Имя экземпляра имеет значение NULL.

Добавлять счетчики в набор счетчиков следует перед созданием экземпляра набора счетчиков.

Примеры

Пример см. в разделе System.Diagnostics.PerformanceData.

Комментарии

Вызовите этот метод один раз для наборов счетчиков с одним экземпляром и один или несколько раз для наборов счетчиков с несколькими экземплярами.

Поставщик определяет, когда он создает экземпляр. Если данные счетчика являются более статическими, поставщик может создать экземпляр во время инициализации. Например, число процессоров на компьютере будет считаться статическим, поэтому поставщик, предоставляющий данные счетчика для процессоров, может создать экземпляр для каждого процессора на компьютере во время инициализации. Для более динамических счетчиков, таких как счетчики дисков или процессов, поставщики создают новые экземпляры в ответ на добавление нового USB-устройства или создания нового процесса.

Поставщик должен постоянно обновлять данные счетчика.

Применяется к