PerformanceCounter.RemoveInstance Método

Definición

Espacio de nombres:

System.Diagnostics

Ensamblado:

System.Diagnostics.PerformanceCounter.dll

Source:

PerformanceCounter.cs

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

public:
 void RemoveInstance();

public void RemoveInstance();

member this.RemoveInstance : unit -> unit

Public Sub RemoveInstance ()

Excepciones

InvalidOperationException

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

O bien

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

O bien

La InstanceLifetime propiedad se establece en Process cuando se usa la memoria compartida global.

Win32Exception

Error al acceder a una API del sistema.

Comentarios

Solo puede quitar una instancia de 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 en instanceName 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 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 crear la categoría.