PerformanceCounter.CounterHelp 屬性

定義

命名空間:

System.Diagnostics

組件:

System.Diagnostics.PerformanceCounter.dll

套件:

System.Diagnostics.PerformanceCounter v8.0.0

來源:

PerformanceCounter.cs

取得這個效能計數器的描述。

public:
 property System::String ^ CounterHelp { System::String ^ get(); };

public string CounterHelp { get; }

member this.CounterHelp : string

Public ReadOnly Property CounterHelp As String

屬性值

String

這個效能計數器所測量的項目或數量的描述。

例外狀況

InvalidOperationException

PerformanceCounter 執行個體沒有與效能計數器相關聯。

-或-

使用全域共用記憶體時，InstanceLifetime 屬性是設定為 Process。

UnauthorizedAccessException

以不具有系統管理員權限執行的程式碼嘗試讀取效能計數器。

備註

性能計數器管理員 MMC 嵌入式管理單元的 [新增計數器] 對話方塊會在使用者從計數器清單中選取計數器時顯示 CounterHelp 文字，然後按兩下 [說明] 按鈕。

當您建立新的計數器時，請使用 CounterHelp 文字來描述計數器監視器的用途，讓使用者可以判斷是否要將計數器新增至系統監視器的顯示。

注意

如果 屬性的值InstanceLifetime是 Process ，且性能計數器類別是以 .NET Framework 1.0 版或 1.1 版建立，InvalidOperationException則會擲回 。 使用舊版所建立的效能計數器類別使用全域共用記憶體，且的值 InstanceLifetime 必須是 Global。 如果 .NET Framework 1.0 版或 1.1 版的應用程式未使用類別，請刪除並重新建立類別。

注意

若要讀取 Windows Vista、Windows XP Professional x64 Edition 或 Windows Server 2003 中的性能計數器，您必須是 效能監視器 Users 群組的成員，或具有系統管理許可權。

若要避免提高您在 Windows Vista 中存取性能計數器的許可權，請將您自己新增至 效能監視器 Users 群組。

在 Windows Vista 中，使用者帳戶控制 (UAC) 會判斷使用者的權限。 如果您是內建 Administrators 群組的成員，系統會將兩個執行階段存取語彙基元 (Token) 指派給您：標準使用者存取語彙基元及管理員存取語彙基元。 根據預設，您會屬於標準使用者角色。 若要執行存取性能計數器的程式代碼，您必須先將許可權從標準使用者提升為系統管理員。 您可以在啟動應用程式時，以滑鼠右鍵按一下應用程式圖示，並指出您想要以系統管理員身分執行，藉此提高為系統管理員權限。