PerformanceCounter.Increment Metoda

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Diagnostics.PerformanceCounter.dll

Zdroj:

PerformanceCounter.cs

Zvýší přidružený čítač výkonu o jeden prostřednictvím efektivní atomické operace.

public:
 long Increment();

public long Increment();

member this.Increment : unit -> int64

Public Function Increment () As Long

Návraty

Int64

Inkrementovaná hodnota čítače.

Výjimky

InvalidOperationException

Čítač je jen pro čtení, takže ji aplikace nemůže zvýšit.

nebo

Instance není správně přidružena k čítači výkonu.

nebo

Vlastnost je nastavena InstanceLifetimeProcess při použití globální sdílené paměti.

Win32Exception

Při přístupu k systémovému rozhraní API došlo k chybě.

Poznámky

Můžete psát jenom na vlastní čítače. Všechny systémové čítače jsou jen pro čtení.

Poznámka:

Funkce Increment, IncrementBya Decrement metody používají vzájemné zámky k aktualizaci hodnoty čítače. To pomáhá udržovat hodnotu čítače přesnou ve scénářích s více vlákny nebo víceprocesy, ale také výsledkem je snížení výkonu. Pokud nepotřebujete přesnost, kterou poskytují vzájemně uzamčené operace, můžete vlastnost aktualizovat RawValue přímo o 5krát vyšší výkon. Ve scénářích s více vlákny ale můžou být některé aktualizace hodnoty čítače ignorovány, což vede k nepřesným datům.

Poznámka:

Pokud je Process hodnota vlastnosti InstanceLifetime a kategorie čítače výkonu byla vytvořena s rozhraním .NET Framework verze 1.0 nebo 1.1, InvalidOperationException vyvolá se vyvolá. Kategorie čítače výkonu vytvořené se staršími verzemi používají globální sdílenou paměť a hodnota musí InstanceLifetime být Global. Pokud kategorie nepoužívá aplikace spuštěné ve verzích 1.0 nebo 1.1 rozhraní .NET Framework, odstraňte kategorii a znovu ji vytvořte.

Bezpečný přístup z více vláken

Tato metoda je bezpečná pro přístup z více vláken.