PerformanceCounter.Increment Método

Definición

Espacio de nombres:

System.Diagnostics

Ensamblado:

System.Diagnostics.PerformanceCounter.dll

Paquete:

System.Diagnostics.PerformanceCounter v8.0.0

Source:

PerformanceCounter.cs

Aumenta el valor del contador de rendimiento asociado en uno, mediante una operación atómica eficaz.

public:
 long Increment();

public long Increment ();

member this.Increment : unit -> int64

Public Function Increment () As Long

Devoluciones

Int64

Valor de contador aumentado.

Excepciones

InvalidOperationException

El contador es de sólo lectura, por lo que la aplicación no puede aumentarlo.

o bien

La instancia no está correctamente asociada a un contador de rendimiento.

o bien

La propiedad InstanceLifetime se ha establecido en Process pero se está usando la memoria compartida global.

Win32Exception

Error de acceso a la API del sistema.

Comentarios

Solo puede escribir en contadores personalizados. Todos los contadores del sistema son de solo lectura.

Nota

Los Incrementmétodos , IncrementByy Decrement usan interbloqueos para actualizar el valor del contador. Esto ayuda a mantener el valor de contador preciso en escenarios multiproceso o multiproceso, pero también produce una penalización de rendimiento. Si no necesita la precisión que proporcionan las operaciones interbloqueadas, puede actualizar la RawValue propiedad directamente para una mejora del rendimiento hasta cinco veces. Sin embargo, en escenarios multiproceso, es posible que se omitan algunas actualizaciones del valor del contador, lo que da lugar a datos inexactos.

Nota

Si el valor de la InstanceLifetime propiedad es Process y la categoría del contador de rendimiento se creó con .NET Framework versión 1.0 o 1.1, se produce una InvalidOperationException excepción . Las categorías de contadores de rendimiento creadas con versiones anteriores usan memoria compartida global y el valor de InstanceLifetime debe ser Global. Si las aplicaciones que se ejecutan en las versiones 1.0 o 1.1 de .NET Framework no usan la categoría, elimine y vuelva a crearla.

Seguridad para subprocesos

Este método es seguro para subprocesos.