PerformanceCounter.CategoryName Свойство

Определение

Пространство имен:

System.Diagnostics

Сборка:

System.Diagnostics.PerformanceCounter.dll

Исходный код:

PerformanceCounter.cs

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

public:
 property System::String ^ CategoryName { System::String ^ get(); void set(System::String ^ value); };

public string CategoryName { get; set; }

member this.CategoryName : string with get, set

Public Property CategoryName As String

Значение свойства

String

Имя категории счетчика производительности (объект производительности), с которым связан этот счетчик производительности.

Исключения

ArgumentNullException

Значение параметра CategoryName — null.

Примеры

В следующем примере кода создается экземпляр PerformanceCounter класса по умолчанию. После создания CategoryNameCounterNameэкземпляра задаются значения свойств и InstanceName значения свойств, а результаты вызова NextValue метода отображаются.

PerformanceCounter performanceCounter = new PerformanceCounter();
performanceCounter.CategoryName = "Process";
performanceCounter.CounterName = "Private Bytes";
performanceCounter.InstanceName = "Explorer";
MessageBox.Show(performanceCounter.NextValue().ToString());

Dim PC As New PerformanceCounter()
PC.CategoryName = "Process"
PC.CounterName = "Private Bytes"
PC.InstanceName = "Explorer"
MessageBox.Show(PC.NextValue().ToString())

Комментарии

Отображается CategoryName в Performance Object диалоговом окне оснастки Add Counter mmC диспетчера счетчиков производительности.

Счетчик производительности отслеживает поведение категории или объекта производительности на компьютере. Категории включают физические компоненты (такие как процессоры, диски и память) и системные объекты (такие как процессы и потоки). Системные счетчики, связанные с тем же объектом производительности, группируются в категорию, которая указывает на их общий фокус. При создании экземпляра PerformanceCounter класса сначала указывается категория, с которой будет взаимодействовать компонент, а затем вы выбираете счетчик из этой категории.

Например, одна категория счетчиков Windows — категория памяти. Системные счетчики в этой категории отслеживают данные памяти, такие как количество доступных байтов и количество кэшированных байтов. Если вы хотите работать с кэшируемыми в приложении байтами, создайте экземпляр PerformanceCounter компонента, подключите его к категории памяти и выберите соответствующий счетчик (в данном случае кэшированные байты) из этой категории.

Хотя ваша система делает гораздо больше категорий счетчиков доступными, категории, которые, вероятно, будут взаимодействовать с наиболее часто кэшем, памятью, объектами, physicalDisk, Process, Processor, Server, System и Thread категорий.

См. также раздел

• ProcessName