PerformanceCounter.RemoveInstance Metoda

Definicja

Przestrzeń nazw:

System.Diagnostics

Zestaw:

System.Diagnostics.PerformanceCounter.dll

Ź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, więc próba usunięcia jednego z nich zgłasza wyjątek.

Uwaga / Notatka

Aby uniknąć możliwego stanu wyścigu po zwolnieniu DomainUnload pamięci udostępnionej 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 w 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 / Notatka

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