PerformanceCounter.RemoveInstance Metoda

Definicja

Przestrzeń nazw:

System.Diagnostics

Zestaw:

System.Diagnostics.PerformanceCounter.dll

Pakiet:

System.Diagnostics.PerformanceCounter v8.0.0

Źródło:

PerformanceCounter.cs

Usuwa wystąpienie kategorii określone przez PerformanceCounter właściwość obiektu InstanceName .

public:
 void RemoveInstance();

public void RemoveInstance ();

member this.RemoveInstance : unit -> unit

Public Sub RemoveInstance ()

Wyjątki

InvalidOperationException

Ten licznik jest tylko do odczytu, więc nie można usunąć żadnego wystąpienia skojarzonego z kategorią.

-lub-

Wystąpienie nie jest poprawnie skojarzone z licznikiem wydajności.

-lub-

Właściwość InstanceLifetime jest ustawiana na Process wartość w przypadku korzystania z globalnej pamięci udostępnionej.

Win32Exception

Wystąpił błąd podczas uzyskiwania dostępu do interfejsu API systemu.

Uwagi

Wystąpienie można usunąć tylko dla licznika niestandardowego. Wszystkie liczniki systemowe są tylko do odczytu, dlatego próba usunięcia jednego z nich zgłasza wyjątek.

Uwaga

Aby uniknąć możliwego warunku wyścigu po zwolnieniu pamięci udostępnionej DomainUnload licznika wydajności, zaleca RemoveInstance się wywołanie metody z programu obsługi zdarzeń.

Aby utworzyć wystąpienie kategorii wydajności, określ element instanceName na konstruktorze PerformanceCounter . Jeśli wystąpienie kategorii określone przez instanceName już istnieje, nowy obiekt będzie odwoływać się do istniejącego wystąpienia kategorii.

Uwaga

Jeśli wartość InstanceLifetime właściwości to Process , a kategoria licznika wydajności została utworzona z .NET Framework w wersji 1.0 lub 1.1, InvalidOperationException zostanie zgłoszony. Kategorie liczników wydajności utworzone we wcześniejszych wersjach używają globalnej pamięci udostępnionej, a wartość parametru InstanceLifetime musi mieć Globalwartość . Jeśli kategoria nie jest używana przez aplikacje działające w wersjach 1.0 lub 1.1 .NET Framework, usuń i utwórz ponownie kategorię.