PerformanceCounter.RemoveInstance Metoda

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Diagnostics.PerformanceCounter.dll

Zdroj:

PerformanceCounter.cs

Odstraní instanci kategorie určenou vlastností objektu PerformanceCounterInstanceName .

public:
 void RemoveInstance();

public void RemoveInstance();

member this.RemoveInstance : unit -> unit

Public Sub RemoveInstance ()

Výjimky

InvalidOperationException

Tento čítač je jen pro čtení, takže každou instanci přidruženou k kategorii nelze odebrat.

nebo

Instance není správně přidružena k čítači výkonu.

nebo

Vlastnost je nastavena InstanceLifetimeProcess při použití globální sdílené paměti.

Win32Exception

Při přístupu k systémovému rozhraní API došlo k chybě.

Poznámky

Instanci můžete odebrat pouze pro vlastní čítač. Všechny čítače systému jsou jen pro čtení, takže při pokusu o odebrání jednoho z nich dojde k výjimce.

Poznámka:

Pokud se chcete vyhnout možnému stavu časování při uvolnění sdílené paměti čítače výkonu, doporučuje RemoveInstance se volat metodu z obslužné rutiny DomainUnload události.

Chcete-li vytvořit instanci kategorie výkonu, zadejte v instanceName konstruktoru PerformanceCounter . Pokud instance kategorie zadaná instanceName již existuje, nový objekt bude odkazovat na existující instanci kategorie.

Poznámka:

Pokud je Process hodnota vlastnosti InstanceLifetime a kategorie čítače výkonu byla vytvořena s rozhraním .NET Framework verze 1.0 nebo 1.1, InvalidOperationException vyvolá se vyvolá. Kategorie čítače výkonu vytvořené se staršími verzemi používají globální sdílenou paměť a hodnota musí InstanceLifetime být Global. Pokud kategorie nepoužívá aplikace spuštěné ve verzích 1.0 nebo 1.1 rozhraní .NET Framework, odstraňte kategorii a znovu ji vytvořte.