PerformanceCounter.InstanceName 属性

定义

命名空间:

System.Diagnostics

程序集:

System.Diagnostics.PerformanceCounter.dll

程序集:

System.dll

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

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

public string InstanceName { get; set; }

[System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string InstanceName { get; set; }

[System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string InstanceName { get; set; }

[System.ComponentModel.SettingsBindable(true)]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string InstanceName { get; set; }

[System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string InstanceName { get; set; }

member this.InstanceName : string with get, set

[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.InstanceName : string with get, set

[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.InstanceName : string with get, set

[<System.ComponentModel.SettingsBindable(true)>]
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.InstanceName : string with get, set

[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.InstanceName : string with get, set

Public Property InstanceName As String

属性值

String

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

属性

TypeConverterAttribute SettingsBindableAttribute

示例

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

PerformanceCounter^ PC = gcnew 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());

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是可以包含无效字符的实例名称的常见源。