PerformanceCounterCategory.Delete(String) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Rimuove la categoria e i contatori associati dal computer locale.
public:
static void Delete(System::String ^ categoryName);public static void Delete(string categoryName);static member Delete : string -> unitPublic Shared Sub Delete (categoryName As String)Parametri
- categoryName
- String
Nome della categoria del contatore delle prestazioni personalizzata da eliminare.
Eccezioni
Il categoryName parametro è null.
Il categoryName parametro ha una sintassi non valida. Può contenere caratteri barra rovesciata ("\") o lunghezza maggiore di 80 caratteri.
Chiamata a un'API di sistema sottostante non riuscita.
Impossibile eliminare la categoria perché non è una categoria personalizzata.
Codice in esecuzione senza privilegi amministrativi che ha tentato di leggere un contatore delle prestazioni.
Esempio
Nell'esempio di codice seguente viene utilizzato il Delete metodo per eliminare un PerformanceCounterCategory oggetto e gli PerformanceCounter oggetti in esso contenuti.
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 categorie di contatori delle prestazioni personalizzate dal sistema. Non è possibile eliminare un contatore da una categoria. A tale scopo, eliminare la categoria e ricreare la categoria con i contatori che si desidera conservare. Per evitare un'eccezione, verificare che la categoria esista prima di tentare di eliminarla.
Note
Per leggere i contatori delle prestazioni da una sessione di accesso non interattiva in Windows Vista e versioni successive, Windows XP Professional x64 Edition o Windows Server 2003, è necessario essere membri del gruppo Monitor prestazioni Users o disporre di privilegi amministrativi.
Per evitare di dover elevare i privilegi per accedere ai contatori delle prestazioni in Windows Vista e versioni successive, aggiungere se stessi al gruppo Utenti di Monitor prestazioni.
In Windows Vista e versioni successive, Controllo account utente determina i privilegi di un utente. Se si è membri del gruppo Administrators predefinito, vengono assegnati due token di accesso in fase di esecuzione: un token di accesso utente standard e un token di accesso amministratore. Per impostazione predefinita, si è nel ruolo utente standard. Per eseguire il codice che accede ai contatori delle prestazioni, è necessario innanzitutto elevare i privilegi dall'utente standard all'amministratore. A tale scopo, è possibile avviare un'applicazione facendo clic con il pulsante destro del mouse sull'icona dell'applicazione e indicando che si vuole eseguire come amministratore.
