PerformanceCounterCategory.Delete(String) Metoda

Definicja

Przestrzeń nazw:

System.Diagnostics

Zestaw:

System.Diagnostics.PerformanceCounter.dll

Pakiet:

System.Diagnostics.PerformanceCounter v11.0.0-preview.7.26381.103

Źródło:

PerformanceCounterCategory.cs

Usuwa kategorię i skojarzone z nią liczniki z komputera lokalnego.

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)

Parametry

categoryName

String

Nazwa niestandardowej kategorii licznika wydajności do usunięcia.

Wyjątki

ArgumentNullException

Parametr categoryName jest null.

ArgumentException

Parametr categoryName ma nieprawidłową składnię. Może zawierać znaki ukośnika odwrotnego ("\") lub mieć długość większą niż 80 znaków.

Win32Exception

Wywołanie podstawowego interfejsu API systemu nie powiodło się.

InvalidOperationException

Nie można usunąć kategorii, ponieważ nie jest to kategoria niestandardowa.

UnauthorizedAccessException

Kod wykonywany bez uprawnień administracyjnych próbował odczytać licznik wydajności.

Przykłady

W poniższym przykładzie kodu użyto Delete metody , aby usunąć obiekt PerformanceCounterCategory i PerformanceCounter , które zawiera.

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

Uwagi

Z systemu można usuwać tylko niestandardowe kategorie liczników wydajności. Nie można usunąć licznika z kategorii. Aby to zrobić, usuń kategorię i ponownie utwórz kategorię przy użyciu liczników, które chcesz zachować. Aby uniknąć wyjątku, upewnij się, że kategoria istnieje przed podjęciem próby jego usunięcia.

Note

Aby odczytać liczniki wydajności z sesji logowania nieinterakcyjnego w systemie Windows Vista i nowszych, Windows XP Professional x64 Edition lub Windows Server 2003, musisz być członkiem grupy Użytkownicy monitora wydajności lub mieć uprawnienia administracyjne.

Aby uniknąć konieczności podniesienia uprawnień dostępu do liczników wydajności w systemie Windows Vista i nowszych, dodaj się do grupy Użytkownicy monitora wydajności.

W systemie Windows Vista i nowszych kontrola konta użytkownika (UAC) określa uprawnienia użytkownika. Jeśli jesteś członkiem wbudowanej grupy Administratorzy, masz przypisane dwa tokeny dostępu w czasie wykonywania: standardowy token dostępu użytkownika i token dostępu administratora. Domyślnie jesteś w roli użytkownika standardowego. Aby wykonać kod, który uzyskuje dostęp do liczników wydajności, musisz najpierw podnieść poziom uprawnień od użytkownika standardowego do administratora. Możesz to zrobić po uruchomieniu aplikacji, klikając prawym przyciskiem myszy ikonę aplikacji i wskazując, że chcesz uruchomić jako administrator.

Zobacz też

• Create(String, String, CounterCreationDataCollection)