PerformanceCounter.RemoveInstance Metódus

Definíció

Névtér:

System.Diagnostics

Szerelvény:

System.Diagnostics.PerformanceCounter.dll

Csomag:

System.Diagnostics.PerformanceCounter v11.0.0-preview.4.26230.115

Forrás:

PerformanceCounter.cs

Törli az objektumtulajdonság PerformanceCounter által megadott kategóriapéldánytInstanceName.

public:
 void RemoveInstance();

public void RemoveInstance();

member this.RemoveInstance : unit -> unit

Public Sub RemoveInstance ()

Kivételek

InvalidOperationException

Ez a számláló írásvédett, így a kategóriához társított példányok nem távolíthatók el.

-vagy-

A példány nincs megfelelően társítva teljesítményszámlálóval.

-vagy-

A InstanceLifetime tulajdonság globális Process megosztott memória használata esetén van beállítva.

Win32Exception

Hiba történt egy rendszer API elérésekor.

Megjegyzések

A példányokat csak egyéni számlálók esetén távolíthatja el. Minden rendszerszámláló írásvédett, ezért az egyik eltávolításának megkísérlése kivételt eredményez.

Note

A teljesítményszámláló megosztott memóriájának felszabadításakor esetleges versenyhelyzet elkerülése érdekében ajánlott a RemoveInstance metódus meghívása az DomainUnload eseménykezelőtől.

Teljesítménykategória-példány létrehozásához adjon meg egy instanceName konstruktort PerformanceCounter . Ha a megadott instanceName kategóriapéldány már létezik, az új objektum a meglévő kategóriapéldányra hivatkozik.

Note

Ha a InstanceLifetime tulajdonság értéke Process, és a teljesítményszámláló kategória .NET Framework 1.0-s vagy 1.1-es verziójával lett létrehozva, a rendszer InvalidOperationException dob. A korábbi verziókban létrehozott teljesítményszámláló-kategóriák globális megosztott memóriát használnak, és a teljesítményszámlálók értékének InstanceLifetime meg kell lennie Global. Ha a kategóriát a .NET-keretrendszer 1.0-s vagy 1.1-s verzióján futó alkalmazások nem használják, törölje és hozza létre újra a kategóriát.