Partager via


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

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