Sdílet prostřednictvím


PerformanceCounter.RemoveInstance Metoda

Definice

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

public:
 void RemoveInstance();
public void RemoveInstance ();
member this.RemoveInstance : unit -> unit
Public Sub RemoveInstance ()

Výjimky

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.

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.

Platí pro