PerformanceCounter.Increment Método

Definição

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

Incrementa o contador de desempenho associado em um através de uma operação atómica eficiente.

public:
 long Increment();
public long Increment();
member this.Increment : unit -> int64
Public Function Increment () As Long

Devoluções

Int64

O valor de contador incrementado.

Exceções

InvalidOperationException

O contador é apenas de leitura, pelo que a aplicação não pode incrementá-lo.

-ou-

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.

Win32Exception

Ocorreu um erro ao aceder a uma API do sistema.

Observações

Só podes escrever em fichas personalizadas. Todos os contadores do sistema são apenas de leitura.

Note

Os Incrementmétodos , IncrementBy, e Decrement usam bloqueios para atualizar o valor do contador. Isto ajuda a manter o valor contador preciso em cenários multithreaded ou multiprocesso, mas também resulta numa penalização de desempenho. Se não precisar da precisão que as operações interligadas proporcionam, pode atualizar a RawValue propriedade diretamente para uma melhoria de desempenho até 5 vezes. No entanto, em cenários multithreaded, algumas atualizações ao valor contador podem ser ignoradas, resultando em dados imprecisos.

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.

Aplica-se a

Segurança de Thread

Este método é seguro para a linha.