PerformanceCounter.InstanceName 属性

定义

命名空间:

System.Diagnostics

程序集:

System.Diagnostics.PerformanceCounter.dll

包:

System.Diagnostics.PerformanceCounter v8.0.0

Source:

PerformanceCounter.cs

获取或设置此性能计数器的实例名称。

public:
 property System::String ^ InstanceName { System::String ^ get(); void set(System::String ^ value); };

public string InstanceName { get; set; }

member this.InstanceName : string with get, set

Public Property InstanceName As String

属性值

String

性能计数器类别实例的名称，或者为空字符串 ("")（如果该计数器是单实例计数器）。

示例

下面的代码示例创建 类的默认实例 PerformanceCounter 。 创建实例后， CategoryName设置 、 CounterName和 InstanceName 属性值，并显示对 NextValue 方法的调用结果。

PerformanceCounter^ PC = gcnew PerformanceCounter;
PC->CategoryName = "Process";
PC->CounterName = "Private Bytes";
PC->InstanceName = "Explorer";
MessageBox::Show( PC->NextValue().ToString() );

PerformanceCounter performanceCounter = new PerformanceCounter();
performanceCounter.CategoryName = "Process";
performanceCounter.CounterName = "Private Bytes";
performanceCounter.InstanceName = "Explorer";
MessageBox.Show(performanceCounter.NextValue().ToString());

Dim PC As New PerformanceCounter()
PC.CategoryName = "Process"
PC.CounterName = "Private Bytes"
PC.InstanceName = "Explorer"
MessageBox.Show(PC.NextValue().ToString())

注解

注意

实例名称的长度必须短于 128 个字符。

在某些情况下，类别被细分为实例，这些实例跟踪有关类别相关对象的多个匹配项的数据。 实例作为整体应用于类别，而不是单个计数器。 类别中的每个计数器都有为类别定义的每个实例。 例如，“进程”类别包含名为 Idle 和 System 的实例。 因此，“进程”类别中的每个计数器都包含每个实例的数据，显示有关空闲进程或系统进程的信息。

许多类别不包含多个实例，因此可以将此属性留空，以指示没有实例与该类别相关联。

如果此 PerformanceCounter 实例指向非自定义类别，则只能从现有类别实例中进行选择。 只能在自定义类别中创建新的类别实例，这样就可以根据需要定义任意数量的计数器和类别实例。

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

注意

请勿在实例名称中使用字符“ (”、“) ”、“#”、“\”或“/”。 如果使用了其中任何字符，则性能控制台 (运行时 分析) 可能无法正确显示实例值。

如果实例名称是自动生成的，并且可能包含字符“ (”、“) ”、“#”、“\”或“/”，请使用下表中的字符映射。

字符	映射字符
(	[
)	]
#	_
\	_
/	_

FriendlyName从 AppDomain.CurrentDomain 属性获取的 AppDomain 对象的 属性是可以包含无效字符的实例名称的常见源。