PerformanceCounterCategory.Delete(String) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Tar bort kategorin och dess associerade räknare från den lokala datorn.
public:
static void Delete(System::String ^ categoryName);public static void Delete(string categoryName);static member Delete : string -> unitPublic Shared Sub Delete (categoryName As String)Parametrar
- categoryName
- String
Namnet på den anpassade prestandaräknarens kategori som ska tas bort.
Undantag
Parametern categoryName är null.
Parametern categoryName har ogiltig syntax. Den kan innehålla omvänt snedstreck ("\") eller ha en längd som är större än 80 tecken.
Ett anrop till ett underliggande system-API misslyckades.
Det går inte att ta bort kategorin eftersom den inte är en anpassad kategori.
Kod som körs utan administratörsbehörighet försökte läsa en prestandaräknare.
Exempel
I följande kodexempel används Delete metoden för att ta bort en PerformanceCounterCategory och de objekt som den PerformanceCounter innehåller.
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
Kommentarer
Du kan bara ta bort anpassade prestandaräknarekategorier från systemet. Du kan inte ta bort en räknare från en kategori. Om du vill göra det tar du bort kategorin och återskapar kategorin med de räknare som du vill behålla. Om du vill undvika ett undantag kontrollerar du att kategorin finns innan du försöker ta bort den.
Note
Om du vill läsa prestandaräknare från en icke-interaktiv inloggningssession i Windows Vista och senare, Windows XP Professional x64 Edition eller Windows Server 2003, måste du antingen vara medlem i gruppen Performance Monitor Användare eller ha administratörsbehörighet.
För att undvika att behöva höja dina privilegier för att få åtkomst till prestandaräknare i Windows Vista och senare lägger du till dig själv i gruppen Performance Monitor Användare.
I Windows Vista och senare bestämmer UAC (User Account Control) en användares behörigheter. Om du är medlem i gruppen Inbyggda administratörer tilldelas du två åtkomsttoken för körning: en standardåtkomsttoken för användare och en administratörsåtkomsttoken. Som standard är du i standardanvändarrollen. Om du vill köra koden som kommer åt prestandaräknare måste du först höja dina privilegier från standardanvändare till administratör. Du kan göra detta när du startar ett program genom att högerklicka på programikonen och ange att du vill köra som administratör.
