PerformanceCounter.Increment Méthode

Définition

Espace de noms:

System.Diagnostics

Assembly:

System.Diagnostics.PerformanceCounter.dll

Source:

PerformanceCounter.cs

Incrémente le compteur de performances associé d’un par le biais 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 de compteur incrémentée.

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

Note

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

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.

Cohérence de thread

Cette méthode est thread safe.