PerformanceCounter.CounterType Propriedade

Definição

Obtém o tipo do contador de desempenho associado.

public:
 property System::Diagnostics::PerformanceCounterType CounterType { System::Diagnostics::PerformanceCounterType get(); };
public System.Diagnostics.PerformanceCounterType CounterType { get; }
member this.CounterType : System.Diagnostics.PerformanceCounterType
Public ReadOnly Property CounterType As PerformanceCounterType

Valor da propriedade

Um PerformanceCounterType que descreve como o contador interage com um aplicativo de monitoramento e a natureza dos valores que ele contém (por exemplo, calculado ou não calculado).

Exceções

A instância não está associada corretamente 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 PerformanceCounterType enumeração contém os tipos de contadores de desempenho com os quais você pode interagir. Alguns dos tipos de contador representam valores calculados, como a média das medidas de contador que o sistema fez. Outros tipos representam valores brutos ou não calculados. A tabela a seguir mostra os tipos de contador com os quais você interagirá com mais frequência.

Responsabilidade do Contador Valor PerformanceCounterType Exemplo
Mantenha uma contagem simples de itens ou operações. NumberOfItems32 Acompanhando o número de pedidos recebidos como um inteiro de 32 bits.
Mantenha uma contagem simples de maior capacidade. NumberOfItems64 Acompanhando o número de pedidos de um site com volume muito alto, armazenado como um inteiro de 64 bits.
Acompanhe o número de itens ou operações por segundo. RateOfCountsPerSecond32 Acompanhamento de pedidos recebidos por segundo em um site.
Acompanhe um número de itens ou operações de maior capacidade por segundo. RateOfCountsPerSecond64 Acompanhamento de pedidos recebidos por segundo em um site com volume muito alto.
Calcular o tempo médio para executar um processo ou processar um item AverageTimer32 Calcule o tempo médio que um pedido leva para ser processado.

Ao criar um contador cujo tipo requer o uso de um contador base correspondente, você deve declarar o contador e a base no CounterCreationDataCollection que você passa para o PerformanceCounterCategory.Create método .

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.

Aplica-se a

Confira também