共用方式為


PerformanceCounter.InstanceName 屬性

定義

取得或設定這個效能計數器的執行個體名稱。

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; }
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
Public Property InstanceName As String

屬性值

效能計數器分類執行個體的名稱,如果計數器是單一執行個體計數器,則為空字串 ("")。

屬性

範例

下列程式代碼範例會建立 類別的預設實例 PerformanceCounter 。 建立 實例之後,會 CategoryName設定 、 CounterNameInstanceName 屬性值,並顯示方法呼叫 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 (請參閱 運行時間分析) 可能無法正確顯示實例值。

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

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

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

適用於