PerformanceCounter.RemoveInstance Metoda

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Diagnostics.PerformanceCounter.dll

Balíček:

System.Diagnostics.PerformanceCounter v8.0.0

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 všechny instance přidružené ke kategorii nelze odebrat.

-nebo-

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

-nebo-

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

Win32Exception

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

Poznámky

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

Poznámka

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

Pokud chcete vytvořit instanci kategorie výkonu, zadejte v instanceName konstruktoru PerformanceCounter hodnotu . Pokud instance kategorie určená uživatelem instanceName již existuje, bude nový objekt odkazovat na existující instanci kategorie.

Poznámka

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