PerformanceCounterCategory.Delete(String) Méthode

Définition

Espace de noms:
System.Diagnostics
Assembly:
System.dll

Supprime la catégorie et ses compteurs associés de l’ordinateur local.

public:
 static void Delete(System::String ^ categoryName);
public static void Delete(string categoryName);
static member Delete : string -> unit
Public Shared Sub Delete (categoryName As String)

Paramètres

categoryName
String

Nom de la catégorie de compteur de performances personnalisée à supprimer.

Exceptions

ArgumentNullException

Le categoryName paramètre est null.

ArgumentException

Le categoryName paramètre a une syntaxe non valide. Il peut contenir des caractères de barre oblique inverse (« \ ») ou avoir une longueur supérieure à 80 caractères.

Win32Exception

Un appel à une API système sous-jacente a échoué.

InvalidOperationException

La catégorie ne peut pas être supprimée, car elle n’est pas une catégorie personnalisée.

UnauthorizedAccessException

Code en cours d’exécution sans privilèges d’administration tenté de lire un compteur de performances.

Exemples

L’exemple de code suivant utilise la Delete méthode pour supprimer un PerformanceCounterCategory et les PerformanceCounter objets qu’il contient.

public static void Main(string[] args)
{
    string categoryName = "";

    // Copy the supplied argument into the local variable.
    try
    {
        categoryName = args[0];
    }
    catch (Exception ex)
    {
        Console.WriteLine("Missing argument identifying category to be deleted.");
    }

    // Delete the specified category.
    try
    {
        if (PerformanceCounterCategory.Exists(categoryName))
        {
            PerformanceCounterCategory.Delete(categoryName);
            Console.WriteLine("Category \"{0}\" deleted from this computer.", categoryName);
        }
        else
        {
            Console.WriteLine("Category name not found");
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine("Unable to delete " +
            "category \"{0}\" from this computer:" + "\n" + ex.Message, categoryName);
    }
}

Sub Main(ByVal args() As String)
    Dim categoryName As String = ""

    ' Copy the supplied argument into the local variable.
    Try
        categoryName = args(0)
    Catch ex As Exception
        Console.WriteLine("Missing argument identifying category to be deleted.")
    End Try

    ' Delete the specified category.
    Try
        If (PerformanceCounterCategory.Exists(categoryName)) Then
            PerformanceCounterCategory.Delete(categoryName)
            Console.WriteLine( _
                "Category ""{0}"" deleted from this computer.", categoryName)
        Else
            Console.WriteLine("Category name not found")
        End If

    Catch ex As Exception
        Console.WriteLine("Unable to delete " & _
            "category ""{0}"" from this computer:" & vbCrLf & _
            ex.Message, categoryName)
    End Try
End Sub

Remarques

Vous pouvez supprimer uniquement les catégories de compteurs de performances personnalisées du système. Vous ne pouvez pas supprimer un compteur d’une catégorie. Pour ce faire, supprimez la catégorie et recréez la catégorie avec les compteurs que vous souhaitez conserver. Pour éviter une exception, vérifiez que la catégorie existe avant de tenter de la supprimer.

Note

Pour lire les compteurs de performances à partir d’une session d’ouverture de session non interactive dans Windows Vista et versions ultérieures, Windows XP Professional x64 Edition ou Windows Server 2003, vous devez être membre du groupe Utilisateurs de l’Analyseur de performances ou disposer de privilèges d’administration.

Pour éviter d’avoir à élever vos privilèges pour accéder aux compteurs de performances dans Windows Vista et versions ultérieures, ajoutez-vous au groupe Utilisateurs de l’Analyseur de performances.

Dans Windows Vista et versions ultérieures, le contrôle de compte d’utilisateur (UAC) détermine les privilèges d’un utilisateur. Si vous êtes membre du groupe Administrateurs intégrés, vous disposez de deux jetons d’accès au moment de l’exécution : un jeton d’accès utilisateur standard et un jeton d’accès administrateur. Par défaut, vous êtes dans le rôle d’utilisateur standard. Pour exécuter le code qui accède aux compteurs de performances, vous devez d’abord élever vos privilèges de l’utilisateur standard à l’administrateur. Pour ce faire, lorsque vous démarrez une application, cliquez avec le bouton droit sur l’icône de l’application et indiquez que vous souhaitez exécuter en tant qu’administrateur.

S’applique à

Voir aussi