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 設定 、 CounterName 和 InstanceName 屬性值，並顯示方法呼叫 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 類別實例已經存在，新的 物件將會參考現有的類別實例。

注意

請勿在實例名稱中使用 「 (」、「) 」、「#」、「 \ 」 或 「/」 字元。 如果使用上述任何字元，Performance Console (請參閱 執行時間分析) 可能無法正確顯示實例值。

如果自動產生實例名稱，而且可能包含 「 (」、「) 」、「# \ 」、「」 或 「/」 字元，請使用下表中的字元對應。

字元	對應的字元
(	[
)	]
#	_
\	_
/	_

FriendlyName從 AppDomain.CurrentDomain 屬性取得之 AppDomain 物件的 屬性是實例名稱的常見來源，可包含無效字元。