PerformanceCounter.RemoveInstance Metoda

Definicja

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

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.

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

Uwagi

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

Uwaga

Aby uniknąć możliwego stanu 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 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

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 jest zgłaszana wartość . 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 .NET Framework, usuń i utwórz ponownie kategorię.

Dotyczy