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-устройства или создания нового процесса.

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