PerformanceCounter.RemoveInstance Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Löscht die von der PerformanceCounter-Eigenschaft des InstanceName-Objekts angegebene Kategorieinstanz.
public:
void RemoveInstance();public void RemoveInstance ();member this.RemoveInstance : unit -> unitPublic Sub RemoveInstance ()Ausnahmen
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.
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.
