PerformanceCounter.RemoveInstance Método

  • Referencia

Definición

Espacio de nombres:
System.Diagnostics
Ensamblado:
System.Diagnostics.PerformanceCounter.dll
Ensamblado:
System.dll
Paquete:
System.Diagnostics.PerformanceCounter v6.0.0
Paquete:
System.Diagnostics.PerformanceCounter v7.0.0
Paquete:
System.Diagnostics.PerformanceCounter v8.0.0
Paquete:
System.Diagnostics.PerformanceCounter v9.0.0-preview.2.24128.5
Source:
PerformanceCounter.cs
Source:
PerformanceCounter.cs
Source:
PerformanceCounter.cs

Elimina la instancia de categoría especificada por la propiedad PerformanceCounter del objeto InstanceName.

public:
 void RemoveInstance();
public void RemoveInstance ();
member this.RemoveInstance : unit -> unit
Public Sub RemoveInstance ()

Excepciones

InvalidOperationException

Este contador es de sólo lectura, por lo que cualquier instancia asociada a la categoría no se puede quitar.

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

Puede quitar una instancia solo para un contador personalizado. Todos los contadores del sistema son de solo lectura, por lo que al intentar quitar uno de ellos se produce una excepción.

Nota

Para evitar una posible condición de carrera cuando se libera la memoria compartida del contador de rendimiento, se recomienda llamar al RemoveInstance método desde el DomainUnload controlador de eventos.

Para crear una instancia de categoría de rendimiento, especifique un instanceName en el PerformanceCounter constructor. Si la instancia de categoría especificada por instanceName ya existe el nuevo objeto hará referencia a la instancia de categoría existente.

Nota

Si el valor de la InstanceLifetime propiedad es Process y la categoría de 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.

Se aplica a