Comment : récupérer les valeurs calculées d'un compteur de performance

Mise à jour : novembre 2007

Pour récupérer les valeurs calculées d'un compteur de performance, appelez la méthode NextValue sur le compteur actif. La valeur calculée du compteur au moment de l'exécution de la méthode est calculée et vous est retournée. Si vous appelez une deuxième fois NextValue, vous récupérerez une valeur différente, parce que la valeur calculée change à mesure que le compteur s'incrémente.

Remarque :
Afin d'obtenir des vues plus complexes des données du compteur, vous pouvez utiliser des échantillons pour récupérer des instantanés statiques des données du compteur à deux points dans le temps et comparer les deux valeurs retournées. Pour plus d'informations sur la récupération d'un échantillon, consultez Comment : récupérer des échantillons de compteurs de performance.

Pour récupérer une valeur calculée de compteur

1. Créez une instance de PerformanceCounter et configurez-la pour interagir avec la catégorie et le compteur choisis. Pour plus d'informations, consultez Comment : créer des instances du composant PerformanceCounter ou Comment : configurer des instances du composant PerformanceCounter.

2. Appelez la méthode NextValue et définissez les résultats comme une variable Single.

   L'exemple suivant montre comment utiliser la propriété NextValue pour récupérer la valeur actuelle du compteur Total dans une catégorie personnalisée appelée Orders :

   Dim MyCtr As New PerformanceCounter()
   MyCtr.CategoryName = "Orders"
   MyCtr.CounterName = "Total"
   Dim retvalue As Single
   retvalue = MyCtr.NextValue()
   

        System.Diagnostics.PerformanceCounter MyCtr =
               new System.Diagnostics.PerformanceCounter();
           MyCtr.CategoryName = "Orders";
           MyCtr.CounterName = "Total";
           float retvalue = MyCtr.NextValue();
   

   Remarque :
   La première fois que vous exécutez ce code, il retourne la valeur zéro. Les requêtes suivantes pour la valeur retournent un chiffre.

Voir aussi

Tâches

Comment : récupérer des échantillons de compteurs de performance

Comment : créer des instances du composant PerformanceCounter

Comment : configurer des instances du composant PerformanceCounter

Concepts

Récupération de la valeur d'un compteur de performance