Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Dekrementiert durch eine effiziente atomare Operation den zugeordneten Leistungsindikator um eins.
Namespace: System.Diagnostics
Assembly: System (in system.dll)
Syntax
'Declaration
Public Function Decrement As Long
'Usage
Dim instance As PerformanceCounter
Dim returnValue As Long
returnValue = instance.Decrement
public long Decrement ()
public:
long long Decrement ()
public long Decrement ()
public function Decrement () : long
Rückgabewert
Der dekrementierte Zählerwert.
Ausnahmen
| Ausnahmetyp | Bedingung |
|---|---|
Der Zähler ist schreibgeschützt, sodass er von der Anwendung nicht dekrementiert 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. |
|
Fehler beim Zugriff auf eine System-API. |
|
Die Plattform ist Windows 98 oder Windows Millennium Edition (Me), die keine Leistungsindikatoren unterstützen. |
Hinweise
Sie können nur in benutzerdefinierte Zähler schreiben. Alle Systemzähler sind schreibgeschützt.
Hinweis
Die Methoden Increment, IncrementBy und Decrement verwendet Interlocks zum Aktualisieren des Zählerwerts. Dies erhöht die Genauigkeit des Zählerwerts in Szenarien mit mehreren Threads oder Prozessen, wirkt sich jedoch negativ auf die Leistung aus. Wenn Sie die Genauigkeit von Interlockoperationen nicht benötigen, können Sie die RawValue-Eigenschaft direkt aktualisieren, woraus sich eine bis zu fünffache Leistungsverbesserung ergibt. Szenarien mit mehreren Threads werden möglicherweise einige Aktualisierungen des Zählerwerts ignoriert, was zu ungenauen Daten führt.
Hinweis
Wenn der Wert für die InstanceLifetime-Eigenschaft Process ist und die Leistungsindikatorkategorie mit .NET Framework, Version 1.0 oder 1.1, erstellt wurde, wird eine InvalidOperationException ausgelöst. Leistungsindikatorkategorien, die mit früheren Versionen erstellt wurden, verwenden den globalen gemeinsam genutzten Speicherbereich, und der Wert für InstanceLifetime muss Global sein. Wenn die Kategorie von Anwendungen unter Version 1.0 oder 1.1 von .NET Framework nicht verwendet wird, löschen Sie die Kategorie, und erstellen Sie sie dann neu.
.NET Framework-Sicherheit
- PerformanceCounterPermission zum Lesen der Leistungsindikatorkategorie, wenn die ReadOnly-Eigenschaft true ist. Zugeordnete Enumeration: PerformanceCounterPermissionAccess.Read
- PerformanceCounterPermission zum Schreiben der Leistungsindikatorkategorie, wenn die ReadOnly-Eigenschaft false ist. Zugeordnete Enumeration: PerformanceCounterPermissionAccess.Write
Plattformen
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
PerformanceCounter-Klasse
PerformanceCounter-Member
System.Diagnostics-Namespace