PerformanceCounter.CategoryName Propriété

Définition

Espace de noms:

System.Diagnostics

Assembly:

System.Diagnostics.PerformanceCounter.dll

Source:

PerformanceCounter.cs

Obtient ou définit le nom de la catégorie de compteur de performances pour ce compteur de performances.

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

Valeur de propriété

String

Nom de la catégorie de compteur de performances (objet de performance) avec laquelle ce compteur de performances est associé.

Exceptions

ArgumentNullException

CategoryName a la valeur null.

Exemples

L’exemple de code suivant crée une instance par défaut de la PerformanceCounter classe. Une fois l’instance créée, les CategoryNamevaleurs , CounterNameet InstanceName les valeurs de propriété sont définies et les résultats d’un appel à la NextValue méthode sont affichés.

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())

Remarques

Le CategoryName composant logiciel enfichable MMC du Gestionnaire de compteurs de performances s’affiche Performance Object dans la boîte de Add Counter dialogue.

Un compteur de performances surveille le comportement d’une catégorie ou d’un objet de performance sur un ordinateur. Les catégories incluent des composants physiques (tels que des processeurs, des disques et de la mémoire) et des objets système (tels que les processus et les threads). Les compteurs système liés au même objet de performances sont regroupés en une catégorie qui indique leur focus commun. Lorsque vous créez une instance de la PerformanceCounter classe, vous indiquez d’abord la catégorie avec laquelle le composant interagit, puis vous choisissez un compteur dans cette catégorie.

Par exemple, une catégorie de compteur Windows est la catégorie Mémoire. Les compteurs système de cette catégorie suivent les données de mémoire, telles que le nombre d’octets disponibles et le nombre d’octets mis en cache. Si vous souhaitez utiliser les octets mis en cache dans votre application, vous devez créer une instance du PerformanceCounter composant, la connecter à la catégorie Mémoire, puis choisir le compteur approprié (dans ce cas, octets mis en cache) dans cette catégorie.

Bien que votre système rend de nombreuses catégories de compteurs disponibles, les catégories avec lesquelles vous interagirez probablement le plus fréquemment sont les catégories cache, Mémoire, Objets, PhysicalDisk, Processus, Processeur, Serveur, Système et Thread.

Voir aussi

• ProcessName