PerformanceCounter.RemoveInstance Méthode

Définition

Espace de noms:

System.Diagnostics

Assembly:

System.Diagnostics.PerformanceCounter.dll

Paquet:

System.Diagnostics.PerformanceCounter v8.0.0

Source:

PerformanceCounter.cs

Supprime l'instance de la catégorie spécifiée par la propriété PerformanceCounter de l'objet InstanceName.

public:
 void RemoveInstance();

public void RemoveInstance ();

member this.RemoveInstance : unit -> unit

Public Sub RemoveInstance ()

Exceptions

InvalidOperationException

Ce compteur est en lecture seule. Toute instance associée à la catégorie ne peut donc pas être supprimée.

- ou -

L'instance n'est pas correctement associée à un compteur de performance.

- ou -

La propriété InstanceLifetime a la valeur Process lorsqu'elle utilise la mémoire partagée globale.

Win32Exception

Une erreur s'est produite lors de l'accès à une API système.

Remarques

Vous pouvez supprimer un instance uniquement pour un compteur personnalisé. Tous les compteurs système étant en lecture seule, la tentative de suppression de l’un d’entre eux lève une exception.

Notes

Pour éviter une condition de concurrence possible lorsque la mémoire partagée du compteur de performances est libérée, il est recommandé d’appeler la RemoveInstance méthode à partir du DomainUnload gestionnaire d’événements.

Pour créer une catégorie de performances instance, spécifiez un instanceName sur le PerformanceCounter constructeur. Si la catégorie instance spécifiée par instanceName existe déjà, le nouvel objet référencera la catégorie existante instance.

Notes

Si la valeur de la InstanceLifetime propriété est Process et que la catégorie de compteurs de performances a été créée avec .NET Framework version 1.0 ou 1.1, une InvalidOperationException exception est levée. Les catégories de compteurs de performances créées avec des versions antérieures utilisent la mémoire partagée globale, et la valeur de InstanceLifetime doit être Global. Si la catégorie n’est pas utilisée par les applications s’exécutant sur les versions 1.0 ou 1.1 du .NET Framework, supprimez et recréez la catégorie.