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.CounterSetInstancePublic Function CreateCounterSetInstance (instanceName As String) As CounterSetInstanceПараметры
- instanceName
- String
Имя экземпляра. Имя должно быть уникальным.
Возвращаемое значение
Экземпляр набора счетчиков, в котором будут содержаться данные счетчиков.
- Атрибуты
Исключения
Имя экземпляра имеет значение NULL.
Добавлять счетчики в набор счетчиков следует перед созданием экземпляра набора счетчиков.
Примеры
Пример см. в разделе System.Diagnostics.PerformanceData.
Комментарии
Вызовите этот метод один раз для наборов счетчиков с одним экземпляром и один или несколько раз для наборов счетчиков с несколькими экземплярами.
Поставщик определяет, когда он создает экземпляр. Если данные счетчика являются более статическими, поставщик может создать экземпляр во время инициализации. Например, число процессоров на компьютере будет считаться статическим, поэтому поставщик, предоставляющий данные счетчика для процессоров, может создать экземпляр для каждого процессора на компьютере во время инициализации. Для более динамических счетчиков, таких как счетчики дисков или процессов, поставщики создают новые экземпляры в ответ на добавление нового USB-устройства или создания нового процесса.
Поставщик должен постоянно обновлять данные счетчика.
