Partager via


PerformanceCounter.Increment Méthode

Définition

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

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

Retours

Valeur incrémentée du compteur.

Exceptions

Le compteur est en lecture seule. L'application ne peut donc pas l'incré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 interlocks pour mettre à jour la valeur du compteur. Cela permet de maintenir la précision de la valeur de compteur dans les scénarios multithread ou multiprocessus, mais entraîne également une baisse des 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 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.

S’applique à

Cohérence de thread

Cette méthode est thread-safe.