PerformanceCounter.CategoryName Propriété

Définition

Espace de noms:

System.Diagnostics

Assembly:

System.Diagnostics.PerformanceCounter.dll

Paquet:

System.Diagnostics.PerformanceCounter v8.0.0

Source:

PerformanceCounter.cs

Obtient ou définit le nom de la catégorie de compteurs de performance de ce compteur de performance.

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 compteurs de performance (objet de performance) à laquelle ce compteur de performance 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 le instance créé, les valeurs de propriété CategoryName, CounterNameet InstanceName sont définies et les résultats d’un appel à la NextValue méthode s’affichent.

PerformanceCounter^ PC = gcnew PerformanceCounter;
PC->CategoryName = "Process";
PC->CounterName = "Private Bytes";
PC->InstanceName = "Explorer";
MessageBox::Show( PC->NextValue().ToString() );

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

s’affiche CategoryName dans le champ de la Performance Object boîte de dialogue de l’ancrage MMC du Gestionnaire de Add Counter compteurs de performances.

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

Par exemple, une catégorie de compteurs 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 un instance du composant, le PerformanceCounter connecter à la catégorie Mémoire, puis sélectionner 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, Process, Processor, Server, System et Thread.

Voir aussi

• ProcessName