PerformanceCounter.RemoveInstance Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee verwijdert u het categorieexemplaren dat is opgegeven door de PerformanceCounter objecteigenschap InstanceName .
public:
void RemoveInstance();public void RemoveInstance();member this.RemoveInstance : unit -> unitPublic Sub RemoveInstance ()Uitzonderingen
Deze teller heeft het kenmerk Alleen-lezen, dus elk exemplaar dat aan de categorie is gekoppeld, kan niet worden verwijderd.
– of –
Het exemplaar is niet correct gekoppeld aan een prestatiemeteritem.
– of –
De InstanceLifetime eigenschap is ingesteld op Process wanneer u globaal gedeeld geheugen gebruikt.
Er is een fout opgetreden bij het openen van een systeem-API.
Opmerkingen
U kunt een exemplaar alleen verwijderen voor een aangepaste teller. Alle systeemtellers hebben het kenmerk Alleen-lezen, dus als u een van deze items probeert te verwijderen, wordt er een uitzondering gegenereerd.
Note
Als u een mogelijke racevoorwaarde wilt voorkomen wanneer het gedeelde geheugen van het prestatiemeteritem wordt vrijgegeven, wordt u aangeraden de RemoveInstance methode aan te roepen vanuit de DomainUnload gebeurtenis-handler.
Als u een exemplaar van een prestatiecategorie wilt maken, geeft u een instanceName op de PerformanceCounter constructor op. Als het categorie-exemplaar dat is opgegeven door instanceName al bestaat, verwijst het nieuwe object naar het bestaande categorie-exemplaar.
Note
Als de waarde voor de eigenschap InstanceLifetimeProcess is en de prestatiemeteritemcategorie is gemaakt met .NET Framework versie 1.0 of 1.1, wordt er een InvalidOperationException gegenereerd. Prestatiemeteritemscategorieën die zijn gemaakt met eerdere versies, maken gebruik van globaal gedeeld geheugen en de waarde hiervoor InstanceLifetime moet zijn Global. Als de categorie niet wordt gebruikt door toepassingen die worden uitgevoerd op versie 1.0 of 1.1 van het .NET Framework, verwijdert en maakt u de categorie opnieuw.
