PerformanceCounter.Increment Methode

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.PerformanceCounter.dll

Quelle:

PerformanceCounter.cs

Erhöht den zugehörigen Leistungsindikator um einen durch einen effizienten atomischen Betrieb.

public:
 long Increment();

public long Increment();

member this.Increment : unit -> int64

Public Function Increment () As Long

Gibt zurück

Int64

Der inkrementierte Zählerwert.

Ausnahmen

InvalidOperationException

Der Leistungsindikator ist schreibgeschützt, sodass die Anwendung sie nicht erhöhen kann.

- oder -

Die Instanz ist nicht ordnungsgemäß mit einem Leistungsindikator verknüpft.

- oder -

Die InstanceLifetime Eigenschaft wird bei Process Verwendung des globalen freigegebenen Speichers festgelegt.

Win32Exception

Fehler beim Zugriff auf eine System-API.

Hinweise

Sie können nur in benutzerdefinierte Leistungsindikatoren schreiben. Alle Systemzähler sind schreibgeschützt.

Hinweis

Die Increment, IncrementByund Decrement Methoden verwenden Verriegelungen, um den Zählerwert zu aktualisieren. Dies trägt dazu bei, den Gegenwert in Multithread- oder Multiprocess-Szenarien genau zu halten, führt aber auch zu Leistungseinbußen. Wenn Sie nicht die Genauigkeit benötigen, die verriegelte Vorgänge bereitstellen, können Sie die RawValue Eigenschaft direkt für eine Leistungsverbesserung von bis zu 5 Mal aktualisieren. In Multithread-Szenarien werden jedoch einige Aktualisierungen des Gegenwerts möglicherweise ignoriert, was zu ungenauen Daten führt.

Hinweis

Wenn der Wert für die InstanceLifetime Eigenschaft lautet Process und die Leistungsindikatorkategorie mit .NET Framework, Version 1.0 oder 1.1, erstellt wurde, wird ein InvalidOperationException Fehler ausgelöst. Leistungsindikatorkategorien, die mit früheren Versionen erstellt wurden, verwenden den globalen freigegebenen Speicher, und der Wert muss InstanceLifetime sein Global. Wenn die Kategorie nicht von Anwendungen verwendet wird, die unter Den Versionen 1.0 oder 1.1 von .NET Framework ausgeführt werden, löschen Sie die Kategorie, und erstellen Sie sie neu.

Threadsicherheit

Diese Methode ist threadsicher.