PerformanceCounterCategory.Delete(String) Método

Definição

Espaço de Nomes:
System.Diagnostics
Assemblagem:
System.dll

Remove a categoria e os seus contadores associados do computador local.

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)

Parâmetros

categoryName
String

O nome da categoria do contador de desempenho personalizado a eliminar.

Exceções

ArgumentNullException

O categoryName parâmetro é null.

ArgumentException

O categoryName parâmetro tem uma sintaxe inválida. Pode conter caracteres com barras inversas ("\") ou ter comprimento superior a 80 caracteres.

Win32Exception

Uma chamada a uma API do sistema subjacente falhou.

InvalidOperationException

A categoria não pode ser eliminada porque não é uma categoria personalizada.

UnauthorizedAccessException

Código que está a executar sem privilégios administrativos tentou ler um contador de desempenho.

Exemplos

O exemplo de código seguinte utiliza o Delete método para eliminar um PerformanceCounterCategory e os PerformanceCounter objetos que ele contém.

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

Observações

Só podes eliminar categorias personalizadas de contadores de desempenho do sistema. Não podes apagar um contador de uma categoria. Para isso, apaga a categoria e recria a categoria com os contadores que queres manter. Para evitar uma exceção, confirme que a categoria existe antes de tentar eliminá-la.

Note

Para ler contadores de desempenho de uma sessão de login não interativa no Windows Vista e versões posteriores, Windows XP Professional x64 Edition ou Windows Server 2003, deve ser membro do grupo Performance Monitor Users ou ter privilégios administrativos.

Para evitar ter de elevar os seus privilégios para aceder a contadores de desempenho no Windows Vista e versões posteriores, adicione-se ao grupo de Utilizadores do Performance Monitor.

No Windows Vista e posteriores, o Controlo de Conta de Utilizador (UAC) determina os privilégios de um utilizador. Se for membro do grupo Administradores Incorporados, é-lhe atribuídos dois tokens de acesso em tempo de execução: um token de acesso de utilizador padrão e um token de acesso de administrador. Por padrão, você está na função de usuário padrão. Para executar o código que acede aos contadores de desempenho, deve primeiro elevar os seus privilégios de utilizador padrão a administrador. Você pode fazer isso ao iniciar um aplicativo clicando com o botão direito do mouse no ícone do aplicativo e indicando que deseja executar como administrador.

Aplica-se a

Ver também