PerformanceCounter.CounterType Propriedade

Definição

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

Obtém o tipo de contador 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 de Propriedade

PerformanceCounterType

A PerformanceCounterType que descreve tanto como o contador interage com uma aplicação de monitorização como a natureza dos valores que contém (por exemplo, calculados ou não calculados).

Exceções

InvalidOperationException

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

-ou-

A InstanceLifetime propriedade é definida para Process quando se utiliza memória partilhada global.

UnauthorizedAccessException

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

Observações

A PerformanceCounterType enumeração contém os tipos de contadores de desempenho com os quais pode interagir. Alguns dos tipos de contadores representam valores calculados, como a média das medições de contador que o sistema realizou. Outros tipos representam valores brutos, ou não calculados. A tabela seguinte mostra os tipos de contadores com que irá interagir com mais frequência.

Responsabilidade do Contador Valor de ContraTipo de Desempenho Example
Mantenha uma contagem simples de itens ou operações. NumberOfItems32 Rastreio do número de ordens recebidas como um inteiro de 32 bits.
Mantenha uma contagem simples de maior capacidade. NumberOfItems64 Rastreio do número de encomendas para um site com volume muito elevado, armazenado como um inteiro de 64 bits.
Registar o número de itens ou operações por segundo. RateOfCountsPerSecond32 Rastreio de encomendas recebidas por segundo num site.
Registar um número maior de itens ou operações por segundo. RateOfCountsPerSecond64 Rastreio de encomendas recebidas por segundo num site com volume muito elevado.
Calcule o tempo médio para realizar um processo ou para processar um item AverageTimer32 Calcule o tempo médio que uma encomenda demora a ser processada.

Quando crias um contador cujo tipo requer o uso de um contador base correspondente, tens de declarar o contador e a base no CounterCreationDataCollection método que passas PerformanceCounterCategory.Create .

Note

Se o valor da propriedade InstanceLifetime for Process e a categoria contador de desempenho foi criada com .NET Framework versão 1.0 ou 1.1, é lançado um InvalidOperationException. As categorias de contadores de desempenho criadas com versões anteriores usam memória partilhada global, e o valor para InstanceLifetime deve ser Global. Se a categoria não for usada por aplicações a correr nas versões 1.0 ou 1.1 do .NET Framework, elimine e recrie a categoria.

Note

Para ler contadores de desempenho no Windows Vista, 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, adicione-se ao grupo Performance Monitor Users.

No Windows Vista, o Controle de Conta de Usuário (UAC) determina os privilégios de um usuário. 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