Comment : vérifier l'existence de compteurs et de catégories

Article
08/21/2008

Mise à jour : novembre 2007

Vous pouvez utiliser la méthode CounterExists sur la classe PerformanceCounterCategory pour déterminer si un certain compteur de performance existe dans une catégorie précise soit sur l'ordinateur local soit sur un ordinateur distant. C'est ce que vous ferez, par exemple, avant de créer un nouveau compteur pour empêcher une erreur due à l'existence d'un autre compteur du même nom.

En plus de déterminer l'existence d'un compteur, vous pouvez déterminer celle d'une catégorie donnée en utilisant la méthode Exists sur la classe PerformanceCounterCategory. C'est ce que vous ferez, par exemple, si vous créez un compteur personnalisé et si vous voulez savoir s'il existe déjà une catégorie pour lui. La méthode Create déclenche une erreur si la catégorie spécifiée a déjà été créée.

Les deux méthodes Exists et CounterExists retournent true si l'élément est trouvé et false s'il ne l'est pas.

Pour déterminer si un compteur existe

Appelez la méthode Exists sur la classe PerformanceCounterCategory et spécifiez les paramètres suivants :

Paramètre	Valeur
CounterName	Le nom du compteur recherché.
CategoryName	Toute catégorie d'objets de performance existant sur le serveur.
MachineName	Serveur sur lequel rechercher la catégorie et le compteur.

Remarque :
En Visual Basic, le paramètre MachineName est optionnel ; si vous ne le définissez pas, l'ordinateur local est utilisé comme valeur par défaut. En C#, vous pouvez utiliser une surcharge de la méthode Exists si vous ne voulez pas spécifier le nom de l'ordinateur.

Pour déterminer si une catégorie existe

Appelez la méthode Exists sur la classe PerformanceCounterCategory et spécifiez les paramètres suivants :

Paramètre	Valeur
CategoryName	Catégorie recherchée.
MachineName	Serveur sur lequel rechercher la catégorie.

L'exemple suivant montre comment utiliser une instruction If pour déterminer si une catégorie existe avant de créer une catégorie et un compteur :

If Not (PerformanceCounterCategory.Exists("MyCat")) Then
    PerformanceCounterCategory.Create( _
       "MyCat", "Description", _
       PerformanceCounterCategoryType.SingleInstance, _
       "MyCounter", "Description")
End If

     if (!System.Diagnostics.PerformanceCounterCategory.Exists("MyCat"))
        {
            System.Diagnostics.PerformanceCounterCategory.Create(
               "MyCat", "Description", PerformanceCounterCategoryType.SingleInstance,
               "MyCounter", "Description");
        }

Voir aussi

Tâches

Comment : écrire des valeurs dans des compteurs de performance

Concepts

Gestion des catégories et des compteurs

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

Partager via