PerformanceCounter.RemoveInstance 方法

定义

命名空间:

System.Diagnostics

程序集:

System.Diagnostics.PerformanceCounter.dll

包:

System.Diagnostics.PerformanceCounter v8.0.0

Source:

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 事件处理程序调用 方法。

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

注意

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