PerformanceCounterCategory.Delete(String) PerformanceCounterCategory.Delete(String) PerformanceCounterCategory.Delete(String) PerformanceCounterCategory.Delete(String) Method

Definizione

Rimuove la categoria e i contatori associati dal computer locale.Removes the category and its associated counters from the local 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)

Parametri

categoryName
String String String String

Il nome della categoria personalizzata di contatori delle prestazioni da eliminare.The name of the custom performance counter category to delete.

Eccezioni

Il valore del parametro categoryName è null.The categoryName parameter is null.

La sintassi del parametro categoryName non è valida.The categoryName parameter has invalid syntax. Probabilmente contiene caratteri di barra rovesciata ("\") o ha una lunghezza maggiore di 80 caratteri.It might contain backslash characters ("\") or have length greater than 80 characters.

Una chiamata ad un'API di sistema sottostante non ha avuto esito positivo.A call to an underlying system API failed.

La categoria non può essere eliminata perché non è una categoria personalizzata.The category cannot be deleted because it is not a custom category.

Codice eseguito senza privilegi di amministratore ha tentato di leggere un contatore delle prestazioni.Code that is executing without administrative privileges attempted to read a performance counter.

Esempi

Nell'esempio di codice seguente viene Delete utilizzato il metodo per PerformanceCounterCategory eliminare un PerformanceCounter oggetto e gli oggetti in esso contenuti.The following code example uses the Delete method to delete a PerformanceCounterCategory and the PerformanceCounter objects that it contains.

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

Commenti

È possibile eliminare solo le categorie di contatori delle prestazioni personalizzate dal sistema.You can delete only custom performance counter categories from the system. Non è possibile eliminare un contatore da una categoria.You cannot delete a counter from a category. A tale scopo, eliminare la categoria e ricreare la categoria con i contatori che si desidera mantenere.To do so, delete the category and recreate the category with the counters you want to retain. Per evitare un'eccezione, verificare che la categoria esista prima di tentare di eliminarla.To avoid an exception, confirm that the category exists before you attempt to delete it.

Nota

Per leggere i contatori delle prestazioni in Windows Vista e versioni successive, Windows XP Professional x64 Edition o Windows Server 2003, è necessario essere un membro del gruppo Performance Monitor Users o disporre di privilegi amministrativi.To read performance counters in Windows Vista and later, Windows XP Professional x64 Edition, or Windows Server 2003, you must either be a member of the Performance Monitor Users group or have administrative privileges.

Per evitare di dover elevare i privilegi per accedere ai contatori delle prestazioni in Windows Vista e versioni successive, aggiungere se stessi al gruppo Performance Monitor Users.To avoid having to elevate your privileges to access performance counters in Windows Vista and later, add yourself to the Performance Monitor Users group.

In Windows Vista e versioni successive i privilegi di un utente sono determinati dalla funzionalità Controllo dell'account utente.In Windows Vista and later, User Account Control (UAC) determines the privileges of a user. Ai membri del gruppo Administrators predefinito vengono assegnati due token di accesso in fase di esecuzione, ovvero un token di accesso utente standard e un token di accesso amministratore.If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. Per impostazione predefinita, viene assegnato il ruolo dell'utente standard.By default, you are in the standard user role. Per eseguire il codice che accede ai contatori delle prestazioni, è innanzitutto necessario elevare i privilegi da utente standard a amministratore.To execute the code that accesses performance counters, you must first elevate your privileges from standard user to administrator. È possibile farlo quando si avvia un'applicazione facendo clic con il pulsante destro del mouse sull'icona dell'applicazione e indicando l'opzione di esecuzione come amministratore.You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator.

Sicurezza

PerformanceCounterPermission
per la lettura delle categorie dei contatori delle prestazioni.for reading performance counter categories. Enumerazione associata: Administer.Associated enumeration: Administer.

Si applica a

Vedi anche