PerformanceCounter.RemoveInstance Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 -> unitPublic Sub RemoveInstance ()Exceptions
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.
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.
