PerformanceCounter.RemoveInstance-Methode
Löscht die von der InstanceName-Eigenschaft des PerformanceCounter-Objekts angegebene Kategorieinstanz.
Namespace: System.Diagnostics
Assembly: System (in system.dll)
Syntax
'Declaration
Public Sub RemoveInstance
'Usage
Dim instance As PerformanceCounter
instance.RemoveInstance
public void RemoveInstance ()
public:
void RemoveInstance ()
public void RemoveInstance ()
public function RemoveInstance ()
Ausnahmen
| Ausnahmetyp | Bedingung |
|---|---|
Dieser Zähler ist schreibgeschützt, sodass die der Kategorie zugeordneten Instanzen nicht entfernt werden können. – 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
Eine Instanz kann nur für einen benutzerdefinierten Zähler entfernt werden. Alle Systemzähler sind schreibgeschützt, sodass bei dem Versuch, einen dieser Zähler zu entfernen, eine Ausnahme ausgelöst wird.
Hinweis
Um bei der Freigabe des gemeinsam genutzten Speicherbereichs eine mögliche Racebedingung zu vermeiden, wird empfohlen, die RemoveInstance-Methode aus dem DomainUnload-Ereignishandler abzurufen.
Geben Sie zum Erstellen einer Instanz einer Leistungskategorie einen instanceName für den PerformanceCounter-Konstruktor an. Wenn die durch instanceName bezeichnete Kategorieinstanz bereits vorhanden ist, verweist das neue Objekt auf die vorhandene Kategorieinstanz.
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 Schreiben der Leistungsindikatorkategorie. 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