PerformanceCounter.InstanceName 属性
获取或设置此性能计数器的实例名称。
**命名空间:**System.Diagnostics
**程序集:**System（在 system.dll 中）
语法
声明
Public Property InstanceName As String
用法
Dim instance As PerformanceCounter
Dim value As String
value = instance.InstanceName
instance.InstanceName = value
public string InstanceName { get; set; }
public:
property String^ InstanceName {
String^ get ();
void set (String^ value);
}
/** @property */
public String get_InstanceName ()
/** @property */
public void set_InstanceName (String value)
public function get InstanceName () : String
public function set InstanceName (value : String)
属性值
性能计数器类别实例的名称，或者为空字符串 ("")（如果该计数器是单实例计数器）。
备注
提示
实例名称的长度必须小于 128 个字符。
在某些情况下，类别被再分为实例，这些实例跟踪一组数据，这些数据记录了与类别相关的对象的多次出现。实例应用于整个类别，而不是应用于单个计数器。类别中的每个计数器均有该类别定义的每个实例。例如，“Process”（进程）类别包含名为 Idle 和 System 的实例。因此，“Process”类别中的每个计数器均包含每个实例的数据，这些数据显示有关空闲 (Idle) 进程或系统 (System) 进程的信息。
许多类别不包含多个实例，因此，您可以保持此属性为空，指示没有实例与此类别关联。
如果此 PerformanceCounter 实例指向非自定义类别，则只能从现有类别实例中选择。您只能在自定义类别中创建新的类别实例，自定义类别允许您根据需要定义任意多个计数器和类别实例。
若要创建性能类别实例，请在 PerformanceCounter 构造函数上指定 instanceName。如果 instanceName 指定的类别实例已经存在，则新对象将引用现有的类别实例。
提示
不要在实例名称中使用字符“(”、“)”、“#”、“\”或“/”。如果使用了上述任何字符，则性能控制台（请参见 运行时分析）可能无法正确显示实例值。
如果实例名称是自动生成的并且可能包含字符“(”、“)”、“#”、“\”或“/”，请使用下表中的字符映射。
字符 |
映射字符 |
|---|---|
( |
[ |
) |
] |
# |
_ |
\ |
_ |
/ |
_ |
从 AppDomain.CurrentDomain 属性获得的 AppDomain 对象的 FriendlyName 属性通常是可能包含无效字符的实例名称的来源。
示例
Dim PC As New PerformanceCounter()
PC.CategoryName = "Process"
PC.CounterName = "Private Bytes"
PC.InstanceName = "Explorer"
MessageBox.Show(PC.NextValue().ToString())
PerformanceCounter PC=new PerformanceCounter();
PC.CategoryName="Process";
PC.CounterName="Private Bytes";
PC.InstanceName="Explorer";
MessageBox.Show(PC.NextValue().ToString());
PerformanceCounter^ PC = gcnew PerformanceCounter;
PC->CategoryName = "Process";
PC->CounterName = "Private Bytes";
PC->InstanceName = "Explorer";
MessageBox::Show( PC->NextValue().ToString() );
PerformanceCounter pc = new PerformanceCounter();
pc.set_CategoryName("Process");
pc.set_CounterName("Private Bytes");
pc.set_InstanceName("Explorer");
MessageBox.Show(((Single)pc.NextValue()).ToString());
平台
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 命名空间