PerformanceCounter.RemoveInstance 方法

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

**命名空间:**System.Diagnostics
**程序集:**System(在 system.dll 中)

语法

声明
Public Sub RemoveInstance
用法
Dim instance As PerformanceCounter

instance.RemoveInstance
public void RemoveInstance ()
public:
void RemoveInstance ()
public void RemoveInstance ()
public function RemoveInstance ()

异常

异常类型 条件

InvalidOperationException

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

- 或 -

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

- 或 -

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

Win32Exception

访问系统 API 时出错。

PlatformNotSupportedException

平台为 Windows 98 或 Windows Millennium Edition (Me),这些平台不支持性能计数器。

备注

只能移除自定义计数器的实例。所有系统计数器都为只读,因而试图移除其中之一将引发异常。

提示

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

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

提示

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

.NET Framework 安全性

平台

Windows 98、Windows 2000 SP4、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表,请参见系统要求

版本信息

.NET Framework

受以下版本支持:2.0、1.1、1.0

请参见

参考

PerformanceCounter 类
PerformanceCounter 成员
System.Diagnostics 命名空间