PerformanceCounter.RemoveInstance Méthode

Définition

Espace de noms:

System.Diagnostics

Assembly:

System.Diagnostics.PerformanceCounter.dll

Source:

PerformanceCounter.cs

Supprime l’instance de catégorie spécifiée par la propriété d’objet PerformanceCounterInstanceName .

public:
 void RemoveInstance();

public void RemoveInstance();

member this.RemoveInstance : unit -> unit

Public Sub RemoveInstance ()

Exceptions

InvalidOperationException

Ce compteur est en lecture seule. Par conséquent, toute instance associée à la catégorie ne peut pas être supprimée.

- ou -

L’instance n’est pas correctement associée à un compteur de performances.

- ou -

La InstanceLifetime propriété est définie Process lors de l’utilisation de 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 une instance uniquement pour un compteur personnalisé. Tous les compteurs système sont en lecture seule. Par conséquent, toute tentative de suppression d’une d’entre elles lève une exception.

Note

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 instance de catégorie de performances, spécifiez un instanceName constructeur PerformanceCounter . Si l’instance de catégorie spécifiée par instanceName existe déjà, le nouvel objet référence l’instance de catégorie existante.

Note

Si la valeur de la InstanceLifetime propriété est Process et que la catégorie de compteur de performances a été créée avec .NET Framework version 1.0 ou 1.1, une InvalidOperationException valeur 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 InstanceLifetime pour laquelle 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.