PerformanceCounter.Increment Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Inkrementiert durch eine effiziente atomare Operation den zugeordneten Leistungsindikator um eins.
public:
long Increment();public long Increment ();member this.Increment : unit -> int64Public Function Increment () As LongGibt zurück
Der inkrementelle Zählerwert.
Ausnahmen
Der Zähler ist schreibgeschützt, sodass er von der Anwendung nicht inkrementiert werden kann.
- oder -
Die Instanz ist keinem Leistungsindikator ordnungsgemäß zugeordnet.
- oder -
Die InstanceLifetime-Eigenschaft wird auf Process festgelegt, wenn der globale gemeinsam genutzte Speicherbereich verwendet wird.
Beim Zugreifen auf eine System-API ist ein Fehler aufgetreten.
Hinweise
Sie können nur in benutzerdefinierte Leistungsindikatoren schreiben. Alle Systemindikatoren sind schreibgeschützt.
Hinweis
Die IncrementMethoden , IncrementByund Decrement verwenden Interlocks, um den Zählerwert zu aktualisieren. Dies trägt dazu bei, den Zählerwert in Multithread- oder Multiprozessszenarien genau zu halten, führt aber auch zu Leistungseinbußen. Wenn Sie die Genauigkeit, die ineinandergreifende Vorgänge bieten, nicht benötigen, können Sie die Eigenschaft direkt aktualisieren, um die RawValue Leistung um das Fünffache zu verbessern. In Multithreadszenarien werden jedoch einige Aktualisierungen des Zählerwerts möglicherweise ignoriert, was zu ungenauen Daten führt.
Hinweis
Wenn der Wert für die InstanceLifetime Eigenschaft ist Process und die Leistungsindikatorkategorie mit .NET Framework Version 1.0 oder 1.1 erstellt wurde, wird ein InvalidOperationException ausgelöst. Leistungsindikatorkategorien, die mit früheren Versionen erstellt wurden, verwenden globalen freigegebenen Arbeitsspeicher, und der Wert für InstanceLifetime muss sein Global. Wenn die Kategorie nicht von Anwendungen verwendet wird, die unter Version 1.0 oder 1.1 des .NET Framework ausgeführt werden, löschen Sie die Kategorie, und erstellen Sie sie neu.
Gilt für:
Threadsicherheit
Diese Methode ist threadsicher.
