PerformanceCounterCategory.Delete(String) Methode

Definitie

Naamruimte:
System.Diagnostics
Assembly:
System.dll

Hiermee verwijdert u de categorie en de bijbehorende tellers van de lokale computer.

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)

Parameters

categoryName
String

De naam van de categorie aangepaste prestatiemeteritems die u wilt verwijderen.

Uitzonderingen

ArgumentNullException

De categoryName parameter is null.

ArgumentException

De categoryName parameter heeft een ongeldige syntaxis. Het kan backslashtekens ("\") bevatten of een lengte van meer dan 80 tekens hebben.

Win32Exception

Een aanroep naar een onderliggende systeem-API is mislukt.

InvalidOperationException

De categorie kan niet worden verwijderd omdat deze geen aangepaste categorie is.

UnauthorizedAccessException

Code die wordt uitgevoerd zonder beheerdersbevoegdheden heeft geprobeerd een prestatiemeteritem te lezen.

Voorbeelden

In het volgende codevoorbeeld wordt de Delete methode gebruikt om een PerformanceCounterCategory en de PerformanceCounter objecten die deze bevat te verwijderen.

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

Opmerkingen

U kunt alleen aangepaste prestatiemeteritemscategorieën uit het systeem verwijderen. U kunt een teller niet verwijderen uit een categorie. U doet dit door de categorie te verwijderen en de categorie opnieuw te maken met de tellers die u wilt behouden. Als u een uitzondering wilt voorkomen, controleert u of de categorie bestaat voordat u deze probeert te verwijderen.

Note

Als u prestatiemeteritems wilt lezen van een niet-interactieve aanmeldingssessie in Windows Vista en hoger, Windows XP Professional x64 Edition of Windows Server 2003, moet u lid zijn van de groep Performance Monitor Gebruikers of beheerdersbevoegdheden hebben.

Als u wilt voorkomen dat u uw bevoegdheden voor toegang tot prestatiemeteritems in Windows Vista en hoger moet verhogen, voegt u uzelf toe aan de groep Performance Monitor Gebruikers.

In Windows Vista en hoger bepaalt UAC (User Account Control) de bevoegdheden van een gebruiker. Als u lid bent van de groep Ingebouwde beheerders, hebt u twee runtime-toegangstokens toegewezen: een standaard toegangstoken voor gebruikers en een beheerderstoegangstoken. Standaard hebt u de standaardgebruikersrol. Als u de code wilt uitvoeren die toegang heeft tot prestatiemeteritems, moet u eerst uw bevoegdheden verhogen van de standaardgebruiker naar de beheerder. U kunt dit doen wanneer u een toepassing start door met de rechtermuisknop op het toepassingspictogram te klikken en aan te geven dat u wilt uitvoeren als beheerder.

Van toepassing op

Zie ook