PerformanceCounter.CounterHelp Propriedade

Definição

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.PerformanceCounter.dll

Pacote:

System.Diagnostics.PerformanceCounter v8.0.0

Origem:

PerformanceCounter.cs

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 : string

Public ReadOnly Property CounterHelp As String

Valor da propriedade

String

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

Exceções

InvalidOperationException

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.

UnauthorizedAccessException

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.