PerformanceCounter.RemoveInstance Methode

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.PerformanceCounter.dll

Paket:

System.Diagnostics.PerformanceCounter v8.0.0

Quelle:

PerformanceCounter.cs

Löscht die von der PerformanceCounter-Eigenschaft des InstanceName-Objekts angegebene Kategorieinstanz.

public:
 void RemoveInstance();

public void RemoveInstance ();

member this.RemoveInstance : unit -> unit

Public Sub RemoveInstance ()

Ausnahmen

InvalidOperationException

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.

Win32Exception

Beim Zugreifen auf eine System-API ist ein Fehler aufgetreten.

Hinweise

Sie können eine instance nur für einen benutzerdefinierten Zähler entfernen. Alle Systemindikatoren sind schreibgeschützt, sodass der Versuch, einen von ihnen zu entfernen, eine Ausnahme auslöst.

Hinweis

Um eine mögliche Racebedingung zu vermeiden, wenn der freigegebene Arbeitsspeicher des Leistungsindikators freigegeben wird, wird empfohlen, die RemoveInstance Methode vom Ereignishandler aus DomainUnload aufgerufen zu werden.

Um eine Leistungskategorie instance zu erstellen, geben Sie einen instanceName für den PerformanceCounter Konstruktor an. Wenn die von instanceName angegebene Kategorie instance bereits vorhanden ist, verweist das neue Objekt auf die vorhandene Kategorie instance.

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 muss sein InstanceLifetimeGlobal. Wenn die Kategorie nicht von Anwendungen verwendet wird, die unter Version 1.0 oder 1.1 der .NET Framework ausgeführt werden, löschen Sie die Kategorie, und erstellen Sie sie neu.