PerformanceCounterCategory.Delete(String) Metoda

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Diagnostics.PerformanceCounter.dll

Balíček:

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

Zdroj:

PerformanceCounterCategory.cs

Odebere kategorii a přidružené čítače z místního počítače.

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

Název vlastní kategorie čítače výkonu, která se má odstranit.

Výjimky

ArgumentNullException

Parametr categoryName je null.

ArgumentException

Parametr categoryName má neplatnou syntaxi. Může obsahovat znaky zpětného lomítka (\) nebo delší než 80 znaků.

Win32Exception

Volání základního systémového rozhraní API selhalo.

InvalidOperationException

Kategorii nelze odstranit, protože se nejedná o vlastní kategorii.

UnauthorizedAccessException

Kód, který se spouští bez oprávnění správce, se pokusil přečíst čítač výkonu.

Příklady

Následující příklad kódu používá metodu Delete k odstranění PerformanceCounterCategory a PerformanceCounter objektů, které obsahuje.

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

Poznámky

Ze systému můžete odstranit pouze vlastní kategorie čítačů výkonu. Z kategorie nelze odstranit čítač. Uděláte to tak, že kategorii odstraníte a znovu vytvoříte kategorii s čítači, které chcete zachovat. Pokud se chcete vyhnout výjimce, ověřte, že kategorie existuje, než se ji pokusíte odstranit.

Note

Chcete-li číst čítače výkonu z neinteraktivní přihlašovací relace v systémech Windows Vista a novějších, Windows XP Professional x64 Edition nebo Windows Server 2003, musíte být členem skupiny Uživatelé sledování výkonu nebo mít oprávnění správce.

Abyste se vyhnuli zvýšení oprávnění pro přístup k čítačům výkonu v systému Windows Vista a novějším, přidejte se do skupiny Uživatelé sledování výkonu.

V systému Windows Vista a novějších určuje řízení uživatelských účtů (UAC) oprávnění uživatele. Pokud jste členem předdefinované skupiny Administrators, máte přiřazené dva přístupové tokeny za běhu: standardní přístupový token uživatele a přístupový token správce. Ve výchozím nastavení jste ve standardní roli uživatele. Pokud chcete spustit kód, který přistupuje k čítačům výkonu, musíte nejprve zvýšit oprávnění od standardního uživatele na správce. Můžete to udělat, když spustíte aplikaci tak, že kliknete pravým tlačítkem myši na ikonu aplikace a označíte, že chcete spustit jako správce.

Viz také

• Create(String, String, CounterCreationDataCollection)