PerformanceCounterCategory.Exists 方法

定義

命名空間:

System.Diagnostics

組件:

System.Diagnostics.PerformanceCounter.dll

套件:

System.Diagnostics.PerformanceCounter v8.0.0

判斷分類是否登錄在系統上。

多載

Exists(String)	判斷分類是否登錄在本機電腦上。
Exists(String, String)	判斷分類是否登錄在指定電腦上。

Exists(String)

來源:

PerformanceCounterCategory.cs

判斷分類是否登錄在本機電腦上。

public:
 static bool Exists(System::String ^ categoryName);

public static bool Exists (string categoryName);

static member Exists : string -> bool

Public Shared Function Exists (categoryName As String) As Boolean

參數

categoryName

String

要尋找的效能計數器分類名稱。

傳回

Boolean

如果分類已登錄，則為 true，否則為 false。

例外狀況

ArgumentNullException

categoryName 參數為 null。

ArgumentException

categoryName 參數是空字串 ("")。

Win32Exception

對基礎系統 API 的呼叫失敗。

UnauthorizedAccessException

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

範例

下列程式代碼範例會判斷名為 「orders」 的物件是否存在 PerformanceCounterCategory 。 如果沒有，它會使用包含兩個CounterCreationDataCollection性能計數器的物件來建立 PerformanceCounterCategory 物件。

if (  !PerformanceCounterCategory::Exists( "Orders" ) )
{
   CounterCreationData^ milk = gcnew CounterCreationData;
   milk->CounterName = "milk";
   milk->CounterType = PerformanceCounterType::NumberOfItems32;

   CounterCreationData^ milkPerSecond = gcnew CounterCreationData;
   milkPerSecond->CounterName = "milk orders/second";
   milkPerSecond->CounterType = PerformanceCounterType::RateOfCountsPerSecond32;

   CounterCreationDataCollection^ ccds = gcnew CounterCreationDataCollection;
   ccds->Add( milkPerSecond );
   ccds->Add( milk );
   PerformanceCounterCategory::Create( "Orders", "Number of processed orders", ccds );
}

if (!PerformanceCounterCategory.Exists("Orders"))
{
    CounterCreationData milk = new CounterCreationData();
    milk.CounterName = "milk";
    milk.CounterType = PerformanceCounterType.NumberOfItems32;

    CounterCreationData milkPerSecond = new CounterCreationData();
    milkPerSecond.CounterName = "milk orders/second";
    milkPerSecond.CounterType = PerformanceCounterType.RateOfCountsPerSecond32;

    CounterCreationDataCollection ccds = new CounterCreationDataCollection();
    ccds.Add(milkPerSecond);
    ccds.Add(milk);

    PerformanceCounterCategory.Create("Orders", "Number of processed orders",
        PerformanceCounterCategoryType.SingleInstance, ccds);
}

If Not PerformanceCounterCategory.Exists("Orders") Then        
    Dim milk As New CounterCreationData()
    milk.CounterName = "milk"
    milk.CounterType = PerformanceCounterType.NumberOfItems32
    
    Dim milkPerSecond As New CounterCreationData()
    milkPerSecond.CounterName = "milk orders/second"
    milkPerSecond.CounterType = PerformanceCounterType.RateOfCountsPerSecond32
    
    Dim ccds As New CounterCreationDataCollection()
    ccds.Add(milkPerSecond)
    ccds.Add(milk)
    
    PerformanceCounterCategory.Create("Orders", "Number of processed orders", _
           PerformanceCounterCategoryType.SingleInstance, ccds)
End If

備註

Exists使用 方法可能會造成明顯的效能負面影響，同時檢查計算機上的所有性能計數器是否有可用性。 如果您只寫入性能計數器，您可以在安裝應用程式時建立性能計數器，並假設存取計數器時有類別，以避免性能計數器的 全域搜尋。 從性能計數器讀取時，無法避免性能計數器搜尋。

注意

若要從 Windows Vista 和更新版本中的非互動式登錄會話讀取性能計數器、Windows XP Professional x64 Edition 或 Windows Server 2003，您必須是 效能監視器 Users 群組的成員，或具有系統管理許可權。

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

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

另請參閱

• CounterExists(String)
• InstanceExists(String)

Exists(String, String)

來源:

PerformanceCounterCategory.cs

判斷分類是否登錄在指定電腦上。

public:
 static bool Exists(System::String ^ categoryName, System::String ^ machineName);

public static bool Exists (string categoryName, string machineName);

static member Exists : string * string -> bool

Public Shared Function Exists (categoryName As String, machineName As String) As Boolean

參數

categoryName

String

要尋找的效能計數器分類名稱。

machineName

String

要為分類檢視的電腦名稱。

傳回

Boolean

如果分類已登錄，則為 true，否則為 false。

例外狀況

ArgumentNullException

categoryName 參數為 null。

ArgumentException

categoryName 參數是空字串 ("")。

-或-

machineName 參數無效。

Win32Exception

對基礎系統 API 的呼叫失敗。

IOException

找不到網路路徑。

UnauthorizedAccessException

呼叫端沒有必要的權限。

-或-

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

範例

下列範例會判斷名為 Orders 的物件是否存在PerformanceCounterCategory。 如果不存在，此範例會 PerformanceCounterCategory 使用包含兩個 CounterCreationDataCollection 性能計數器的 物件來建立 物件。

if (  !PerformanceCounterCategory::Exists( "Orders" ) )
{
   CounterCreationData^ milk = gcnew CounterCreationData;
   milk->CounterName = "milk";
   milk->CounterType = PerformanceCounterType::NumberOfItems32;

   CounterCreationData^ milkPerSecond = gcnew CounterCreationData;
   milkPerSecond->CounterName = "milk orders/second";
   milkPerSecond->CounterType = PerformanceCounterType::RateOfCountsPerSecond32;

   CounterCreationDataCollection^ ccds = gcnew CounterCreationDataCollection;
   ccds->Add( milkPerSecond );
   ccds->Add( milk );
   PerformanceCounterCategory::Create( "Orders", "Number of processed orders", ccds );
}

if (!PerformanceCounterCategory.Exists("Orders"))
{
    CounterCreationData milk = new CounterCreationData();
    milk.CounterName = "milk";
    milk.CounterType = PerformanceCounterType.NumberOfItems32;

    CounterCreationData milkPerSecond = new CounterCreationData();
    milkPerSecond.CounterName = "milk orders/second";
    milkPerSecond.CounterType = PerformanceCounterType.RateOfCountsPerSecond32;

    CounterCreationDataCollection ccds = new CounterCreationDataCollection();
    ccds.Add(milkPerSecond);
    ccds.Add(milk);

    PerformanceCounterCategory.Create("Orders", "Number of processed orders",
        PerformanceCounterCategoryType.SingleInstance, ccds);
}

If Not PerformanceCounterCategory.Exists("Orders") Then        
    Dim milk As New CounterCreationData()
    milk.CounterName = "milk"
    milk.CounterType = PerformanceCounterType.NumberOfItems32
    
    Dim milkPerSecond As New CounterCreationData()
    milkPerSecond.CounterName = "milk orders/second"
    milkPerSecond.CounterType = PerformanceCounterType.RateOfCountsPerSecond32
    
    Dim ccds As New CounterCreationDataCollection()
    ccds.Add(milkPerSecond)
    ccds.Add(milk)
    
    PerformanceCounterCategory.Create("Orders", "Number of processed orders", _
           PerformanceCounterCategoryType.SingleInstance, ccds)
End If

備註

Exists使用 方法可能會造成明顯的效能負面影響，同時檢查計算機上的所有性能計數器是否有可用性。 如果您只寫入性能計數器，您可以在安裝應用程式時建立性能計數器，並假設存取計數器時有類別，以避免性能計數器的 全域搜尋。 從性能計數器讀取時，無法避免性能計數器搜尋。

注意

若要從 Windows Vista 和更新版本中的非互動式登錄會話讀取性能計數器、Windows XP Professional x64 Edition 或 Windows Server 2003，您必須是 效能監視器 Users 群組的成員，或具有系統管理許可權。

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

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

另請參閱

• CounterExists(String)
• InstanceExists(String)