Partager via


PerformanceCounter.Decrement Méthode

Définition

Décrémente d'une unité le compteur de performance associé, à l'aide d'une opération atomique efficace.

public:
 long Decrement();
public long Decrement ();
member this.Decrement : unit -> int64
Public Function Decrement () As Long

Retours

Valeur décrémentée du compteur.

Exceptions

Le compteur est en lecture seule. L'application ne peut donc pas le décrémenter.

- 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 écrire uniquement dans des compteurs personnalisés. Tous les compteurs système sont en lecture seule.

Notes

Les Incrementméthodes , IncrementByet Decrement utilisent des verrous pour mettre à jour la valeur du compteur. Cela permet de maintenir la précision de la valeur du compteur dans les scénarios multithread ou multiprocessus, mais entraîne également une pénalité de performances. Si vous n’avez pas besoin de la précision que fournissent les opérations verrouillées, vous pouvez mettre à jour la RawValue propriété directement pour une amélioration des performances jusqu’à 5 fois. Toutefois, dans les scénarios multithread, certaines mises à jour de la valeur du compteur peuvent être ignorées, ce qui entraîne des données inexactes.

Notes

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 pour 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.

S’applique à

Cohérence de thread

Cette méthode est thread safe.