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 ()
异常
异常类型 | 条件 |
---|---|
此计数器为只读,因而不能移除与该类别关联的任何实例。 - 或 - 此实例未与性能计数器正确关联。 - 或 - 使用全局共享内存时,InstanceLifetime 属性设置为 Process。 |
|
访问系统 API 时出错。 |
|
平台为 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 安全性
- PerformanceCounterPermission 用于写入性能计数器类别。关联的枚举:PerformanceCounterPermissionAccess.Write。
平台
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 命名空间