PerformanceCounter.RemoveInstance Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Elimina la instancia de categoría especificada por la propiedad PerformanceCounter del objeto InstanceName.
public:
void RemoveInstance();public void RemoveInstance ();member this.RemoveInstance : unit -> unitPublic Sub RemoveInstance ()Excepciones
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.
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.
