PerformanceCounter.CounterHelp Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém a descrição para este contador de desempenho.
public:
property System::String ^ CounterHelp { System::String ^ get(); };public string CounterHelp { get; }member this.CounterHelp : stringPublic ReadOnly Property CounterHelp As StringValor da propriedade
Uma descrição do item ou quantidade que esse contador de desempenho mede.
Exceções
A instância PerformanceCounter não está associada a um contador de desempenho.
- ou -
A propriedade InstanceLifetime está definida como Process ao usar a memória global compartilhada.
Um código em execução sem privilégios administrativos tentou ler um contador de desempenho.
Comentários
A caixa de diálogo Adicionar Contadores do snap do MMC do Gerenciador de Contadores de Desempenho exibe o CounterHelp texto quando um usuário seleciona um contador na lista de contadores e clica no botão Explicar.
Ao criar um novo contador, use o CounterHelp texto para descrever o que o contador monitora para que o usuário possa determinar se deseja adicionar o contador à exibição do Monitor do Sistema.
Observação
Se o valor da InstanceLifetime propriedade for Process e a categoria do contador de desempenho tiver sido criada com .NET Framework versão 1.0 ou 1.1, um InvalidOperationException será gerado. As categorias de contador de desempenho criadas com versões anteriores usam memória compartilhada global e o valor para InstanceLifetime deve ser Global. Se a categoria não for usada por aplicativos em execução nas versões 1.0 ou 1.1 do .NET Framework, exclua e recrie a categoria.
Observação
Para ler contadores de desempenho no Windows Vista, Windows XP Professional x64 Edition ou Windows Server 2003, você deve ser membro do grupo Monitor de Desempenho Usuários ou ter privilégios administrativos.
Para evitar ter que elevar seus privilégios para acessar contadores de desempenho no Windows Vista, adicione-se ao grupo Monitor de Desempenho Usuários.
No Windows Vista, o UAC (Controle de Conta de Usuário) determina os privilégios de um usuário. Se for um membro do grupo Administradores Internos, você receberá dois tokens de acesso do tempo de execução: um token de acesso do usuário padrão e um token de acesso do administrador. Por padrão, você está na função de usuário padrão. Para executar o código que acessa contadores de desempenho, primeiro você deve elevar seus privilégios de usuário padrão para administrador. Você pode fazer isso ao iniciar um aplicativo, clicando com o botão direito do mouse no ícone do aplicativo e indicando que você deseja executar como administrador.
