PerformanceCounter.RemoveInstance Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
Opinia
https://aka.ms/ContentUserFeedback.
Już wkrótce: w ciągu 2024 r. będziemy stopniowo usuwać problemy z usługą GitHub jako mechanizm opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla