PerformanceCounter.RemoveInstance Метод

Определение

Удаляет экземпляр категории, указанной объектом PerformanceCounter свойства InstanceName.

public:
 void RemoveInstance();
public void RemoveInstance ();
member this.RemoveInstance : unit -> unit
Public Sub RemoveInstance ()

Исключения

Счетчик доступен только для чтения, поэтому любой экземпляр, связанный с данной категорией, не может быть удален.

-или-

Экземпляр класса, неправильно связанный со счетчиком производительности.

-или-

При использовании глобальной общей памяти свойству InstanceLifetime присваивается значение Process.

Произошла ошибка при обращении к API-интерфейсу системы.

Комментарии

Экземпляр можно удалить только для настраиваемого счетчика. Все системные счетчики доступны только для чтения, поэтому при попытке удалить один из них создается исключение.

Примечание

Чтобы избежать возможного состояния гонки при освобождении общей памяти счетчика производительности, рекомендуется RemoveInstance вызвать метод из обработчика DomainUnload событий.

Чтобы создать экземпляр категории производительности, укажите в instanceName конструкторе PerformanceCounter . Если экземпляр категории, указанный параметром , instanceName уже существует, новый объект будет ссылаться на существующий экземпляр категории.

Примечание

Если свойство имеет значение InstanceLifetime , Process а категория счетчика производительности была создана с платформа .NET Framework версии 1.0 или 1.1, создается исключение InvalidOperationException . Категории счетчиков производительности, созданные в более ранних версиях, используют глобальную общую память, а значение для InstanceLifetime должно иметь значение Global. Если категория не используется приложениями, работающими в версии 1.0 или 1.1 платформа .NET Framework, удалите и повторно создайте категорию.

Применяется к