PerformanceCounter.RemoveInstance Метод

Определение

Пространство имен:

System.Diagnostics

Сборка:

System.Diagnostics.PerformanceCounter.dll

Исходный код:

PerformanceCounter.cs

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

public:
 void RemoveInstance();

public void RemoveInstance();

member this.RemoveInstance : unit -> unit

Public Sub RemoveInstance ()

Исключения

InvalidOperationException

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

–или–

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

–или–

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

Win32Exception

Ошибка при доступе к системным API.

Комментарии

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

Замечание

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

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

Замечание

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