PerformanceCounter.InstanceName 屬性

定義

命名空間:

System.Diagnostics

組件:

System.Diagnostics.PerformanceCounter.dll

套件:

System.Diagnostics.PerformanceCounter v8.0.0

來源:

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 類別實例已經存在，新的物件將會參考現有的類別實例。

注意

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

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

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

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