Architecture de programmation des compteurs de performance
Mise à jour : novembre 2007
Le composant PerformanceCounter utilise ces portions des espaces de noms Microsoft .NET Framework :
Espace de noms PerformanceCounter
Lorsque vous ajoutez une instance du composant PerformanceCounter à votre application, Visual Studio crée automatiquement les références et les instructions d'importation nécessaires pour accéder à l'espace de noms et aux classes. Toutefois, si vous créez vos instances PerformanceCounter dans le code, il vous faudra peut-être créer une référence à System.dll et ajouter une instruction à votre importation de projet (en Visual Basic) ou votre utilisation (en C#) de l'espace de noms approprié (tel que System.Diagnostics).
Pour plus d'informations sur l'ajout et la suppression des références de projet, consultez Comment : ajouter ou supprimer des références dans Visual Studio (Visual Basic).
Principales classes de compteur de performance
Les principales classes associées aux composants PerformanceCounter sont les suivantes :
System.Diagnostics.PerformanceCounter — classe de base servant à créer des composants PerformanceCounter et à interagir avec leurs valeurs.
PerformanceCounterCategory — permet l'accès aux catégories pour lesquelles des compteurs de performance existent sur un serveur ainsi qu'à toutes les propriétés et méthodes qui leur correspondent. Utilisez les méthodes de cette classe pour créer des catégories et des compteurs personnalisés, pour vérifier l'existence des catégories et compteurs et pour lire les compteurs existant dans une catégorie.
System.Diagnostics.CounterCreationData — permet de créer plusieurs compteurs pour une catégorie et de choisir explicitement le type de chaque compteur créé.
System.Diagnostics.InstanceData — permet de récupérer plusieurs instances d'un compteur et toutes les propriétés et méthodes qui leur correspondent.
Principaux éléments de programmation des classes PerformanceCounter et PerformanceCounterCategory
Vous pouvez utiliser les méthodes suivantes pour interagir avec les compteurs de performance :
Utilisez la méthode Create sur la classe PerformanceCounterCategory pour définir une nouvelle catégorie contenant un ou plusieurs compteurs. De même, la méthode Delete supprime une catégorie définie par l'utilisateur et les compteurs qu'elle contient.
Utilisez la méthode Exists sur la classe PerformanceCounterCategory pour déterminer si une catégorie de compteurs existe déjà.
Utilisez la méthode Increment ou IncrementBy sur la classe PerformanceCounter pour incrémenter une valeur de compteur d'une unité ou de l'entier spécifié et pour retourner la nouvelle valeur du compteur. De même, vous pouvez utiliser la méthode Decrement pour diminuer la valeur d'un compteur.
Utilisez la méthode NextValue sur la classe PerformanceCounter pour retourner la valeur calculée suivante de l'échantillon ou la méthode NextSample pour retourner l'échantillonnage suivant.
Utilisez la méthode GetCounters sur la classe PerformanceCounterCategory pour retourner un tableau des compteurs appartenant à une catégorie.
Voir aussi
Tâches
Comment : ajouter ou supprimer des références dans Visual Studio (Visual Basic)