PerformanceCounter.Increment Méthode

Définition

Espace de noms:

System.Diagnostics

Assembly:

System.Diagnostics.PerformanceCounter.dll

Paquet:

System.Diagnostics.PerformanceCounter v8.0.0

Source:

PerformanceCounter.cs

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

Int64

Valeur incrémentée du compteur.

Exceptions

InvalidOperationException

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.

Win32Exception

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.

Cohérence de thread

Cette méthode est thread-safe.