PerformanceCounter.CounterHelp Propriedade

Definição

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.PerformanceCounter.dll

Origem:

PerformanceCounter.cs

Obtém a descrição deste contador de desempenho.

public:
 property System::String ^ CounterHelp { System::String ^ get(); };

public string CounterHelp { get; }

member this.CounterHelp : string

Public ReadOnly Property CounterHelp As String

Valor da propriedade

String

Uma descrição do item ou quantidade que este contador de desempenho mede.

Exceções

InvalidOperationException

A PerformanceCounter instância não está associada a um contador de desempenho.

- ou -

A InstanceLifetime propriedade é definida ao usar memória Process compartilhada global.

UnauthorizedAccessException

Código que está sendo executado 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 os monitores de contador fazem 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 de contador de desempenho tiver sido criada com o .NET Framework versão 1.0 ou 1.1, será gerada uma InvalidOperationException . As categorias de contador de desempenho criadas com versões anteriores usam memória compartilhada global e o valor deve InstanceLifetime 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 Usuários do Monitor de Desempenho 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 Usuários do Monitor de Desempenho.

No Windows Vista, o UAC (Controle de Conta de Usuário) determina os privilégios de um usuário. Se você for membro do grupo Administradores Internos, será atribuído dois tokens de acesso em tempo de execução: um token de acesso de usuário 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 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 deseja executar como administrador.