PerformanceCounter.RemoveInstance Methode

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.PerformanceCounter.dll

Quelle:

PerformanceCounter.cs

Löscht die durch die PerformanceCounter Objekteigenschaft InstanceName 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 jede Instanz, die der Kategorie zugeordnet ist, nicht entfernt werden kann.

- oder -

Die Instanz ist nicht ordnungsgemäß mit einem Leistungsindikator verknüpft.

- oder -

Die InstanceLifetime Eigenschaft wird bei Process Verwendung des globalen freigegebenen Speichers festgelegt.

Win32Exception

Fehler beim Zugriff auf eine System-API.

Hinweise

Sie können eine Instanz nur für einen benutzerdefinierten Zähler entfernen. Alle Systemzähler sind schreibgeschützt, daher löst der Versuch, einen dieser Zähler zu entfernen, eine Ausnahme aus.

Hinweis

Um eine mögliche Racebedingung zu vermeiden, wenn der freigegebene Leistungsindikator freigegebenen Speicher freigegeben wird, wird empfohlen, die RemoveInstance Methode vom DomainUnload Ereignishandler aufgerufen zu werden.

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

Hinweis

Wenn der Wert für die InstanceLifetime Eigenschaft lautet Process und die Leistungsindikatorkategorie mit .NET Framework, Version 1.0 oder 1.1, erstellt wurde, wird ein InvalidOperationException Fehler ausgelöst. Leistungsindikatorkategorien, die mit früheren Versionen erstellt wurden, verwenden den globalen freigegebenen Speicher, und der Wert muss InstanceLifetime sein Global. Wenn die Kategorie nicht von Anwendungen verwendet wird, die unter Den Versionen 1.0 oder 1.1 von .NET Framework ausgeführt werden, löschen Sie die Kategorie, und erstellen Sie sie neu.