PerformanceCounter.RemoveInstance 方法

定义

删除由 PerformanceCounter 对象的 InstanceName 属性指定的类别实例。

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

例外

此计数器为只读,因而不能移除与该类别关联的任何实例。

- 或 -

此实例未与性能计数器正确关联。

- 或 -

使用全局共享内存时,InstanceLifetime 属性设置为 Process

访问 API 时出错。

注解

只能删除自定义计数器的实例。 所有系统计数器都是只读的,因此尝试删除其中一个计数器会引发异常。

注意

为了避免在释放性能计数器共享内存时可能出现的争用情况,建议 RemoveInstanceDomainUnload 事件处理程序调用 方法。

若要创建性能类别实例,请在构造函数上PerformanceCounter指定 instanceName 。 如果指定的 instanceName 类别实例已存在,则新对象将引用现有的类别实例。

注意

如果 属性ProcessInstanceLifetime值为 ,并且性能计数器类别是使用 .NET Framework 版本 1.0 或 1.1 创建的,InvalidOperationException则会引发 。 使用早期版本创建的性能计数器类别使用全局共享内存,并且 的值 InstanceLifetime 必须为 Global。 如果.NET Framework版本 1.0 或 1.1 上运行的应用程序未使用该类别,请删除并重新创建该类别。

适用于