PerformanceCounterCategory.GetCategories メソッド

リファレンス

定義

名前空間:: System.Diagnostics

アセンブリ:: System.Diagnostics.PerformanceCounter.dll

アセンブリ:: System.dll

パッケージ:: System.Diagnostics.PerformanceCounter v6.0.0

パッケージ:: System.Diagnostics.PerformanceCounter v7.0.0

パッケージ:: System.Diagnostics.PerformanceCounter v8.0.0

パッケージ:: System.Diagnostics.PerformanceCounter v9.0.0-preview.2.24128.5

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

コンピューターに登録されているパフォーマンスカウンターカテゴリの一覧を取得します。

オーバーロード

GetCategories()	ローカルコンピューターに登録されているパフォーマンスカウンターカテゴリの一覧を取得します。
GetCategories(String)	指定したコンピューターに登録されているパフォーマンスカウンターカテゴリの一覧を取得します。

GetCategories()

ソース:: PerformanceCounterCategory.cs

ソース:: PerformanceCounterCategory.cs

ソース:: PerformanceCounterCategory.cs

ローカルコンピューターに登録されているパフォーマンスカウンターカテゴリの一覧を取得します。

public:
 static cli::array <System::Diagnostics::PerformanceCounterCategory ^> ^ GetCategories();

public static System.Diagnostics.PerformanceCounterCategory[] GetCategories ();

static member GetCategories : unit -> System.Diagnostics.PerformanceCounterCategory[]

Public Shared Function GetCategories () As PerformanceCounterCategory()

戻り値

PerformanceCounterCategory[]

ローカルコンピューターに登録されているカテゴリを指す PerformanceCounterCategory オブジェクトの配列。

例外

Win32Exception

基になるシステム API の呼び出しに失敗しました。

UnauthorizedAccessException

管理特権を使用せずに実行されているコードがパフォーマンスカウンターの読み取りを試みました。

例

次のコード例では、メソッドを GetCategories 使用して、ローカルコンピューターまたは指定したコンピューターからオブジェクトの PerformanceCounterCategory 配列を返します。配列を PerformanceCounterCategory カテゴリ名の配列に変換し、ユーザーの並べ替えと表示を行います。オーバーロードは GetCategories 、コンピューター名が指定されたかどうかに基づいて選択されます。

public:
    static void Main(array<String^>^ args)
    {
        String^ machineName = "";
        array<PerformanceCounterCategory^>^ categories;

        // Copy the machine name argument into the local variable.
        try
        {
            machineName = args[1]=="."? "": args[1];
        }
        catch (...)
        {
        }

        // Generate a list of categories registered on the specified computer.
        try
        {
            if (machineName->Length > 0)
            {
                categories = PerformanceCounterCategory::GetCategories(machineName);
            }
            else
            {
                categories = PerformanceCounterCategory::GetCategories();
            }
        }
        catch(Exception^ ex)
        {
            Console::WriteLine("Unable to get categories on " +
                (machineName->Length > 0 ? "computer \"{0}\":": "this computer:"), machineName);
            Console::WriteLine(ex->Message);
            return;
        }

        Console::WriteLine("These categories are registered on " +
            (machineName->Length > 0 ? "computer \"{0}\":": "this computer:"), machineName);

        // Create and sort an array of category names.
        array<String^>^ categoryNames = gcnew array<String^>(categories->Length);
        int objX;
        for (objX = 0; objX < categories->Length; objX++)
        {
            categoryNames[objX] = categories[objX]->CategoryName;
        }
        Array::Sort(categoryNames);

        for (objX = 0; objX < categories->Length; objX++)
        {
            Console::WriteLine("{0,4} - {1}", objX + 1, categoryNames[objX]);
        }
    }

public static void Main(string[] args)
{
    string machineName = "";
    PerformanceCounterCategory[] categories;

    // Copy the machine name argument into the local variable.
    try
    {
        machineName = args[0]=="."? "": args[0];
    }
    catch
    {
    }

    // Generate a list of categories registered on the specified computer.
    try
    {
        if (machineName.Length > 0)
        {
            categories = PerformanceCounterCategory.GetCategories(machineName);
        }
        else
        {
            categories = PerformanceCounterCategory.GetCategories();
        }
    }
    catch(Exception ex)
    {
        Console.WriteLine("Unable to get categories on " +
            (machineName.Length > 0 ? "computer \"{0}\":": "this computer:"), machineName);
        Console.WriteLine(ex.Message);
        return;
    }

    Console.WriteLine("These categories are registered on " +
        (machineName.Length > 0 ? "computer \"{0}\":": "this computer:"), machineName);

    // Create and sort an array of category names.
    string[] categoryNames = new string[categories.Length];
    int objX;
    for(objX = 0; objX < categories.Length; objX++)
    {
        categoryNames[objX] = categories[objX].CategoryName;
    }
    Array.Sort(categoryNames);

    for(objX = 0; objX < categories.Length; objX++)
    {
        Console.WriteLine("{0,4} - {1}", objX + 1, categoryNames[objX]);
    }
}

Sub Main(ByVal args() As String)
    Dim machineName As String = ""
    Dim categories() As PerformanceCounterCategory

    ' Copy the machine name argument into the local variable.
    Try
        machineName = IIf(args(0) = ".", "", args(0))
    Catch ex As Exception
    End Try

    ' Generate a list of categories registered on the specified computer.
    Try
        If machineName.Length > 0 Then
            categories = _
                PerformanceCounterCategory.GetCategories(machineName)
        Else
            categories = PerformanceCounterCategory.GetCategories()
        End If
    Catch ex As Exception
        Console.WriteLine("Unable to get categories on " & _
            IIf(machineName.Length > 0, "computer ""{0}"":", _
            "this computer:"), machineName)
        Console.WriteLine(ex.Message)
        Return
    End Try

    Console.WriteLine("These categories are registered on " & _
        IIf(machineName.Length > 0, _
            "computer ""{0}"":", "this computer:"), machineName)

    ' Create and sort an array of category names.
    Dim categoryNames(categories.Length - 1) As String
    Dim objX As Integer
    For objX = 0 To categories.Length - 1
        Console.WriteLine("{0}, {1}", objX, categories(objX).CategoryName)
        categoryNames(objX) = categories(objX).CategoryName
    Next objX
    Array.Sort(categoryNames)

    For objX = 0 To categories.Length - 1
        Console.WriteLine("{0,4} - {1}", objX + 1, categoryNames(objX))
    Next objX
End Sub

注釈

注意

Windows Vista 以降、Windows XP Professional x64 Edition、または Windows Server 2003 の非対話型ログオンセッションからパフォーマンスカウンターを読み取るには、パフォーマンスモニター Users グループのメンバーであるか、管理者特権を持っている必要があります。

Windows Vista 以降のパフォーマンスカウンターにアクセスするために特権を昇格させる必要がないようにするには、パフォーマンスモニター Users グループに自分自身を追加します。

Windows Vista 以降では、ユーザーアカウント制御 (UAC: User Account Control) でユーザーの権限が決定されます。ユーザーが組み込みの Administrators グループのメンバーである場合、そのユーザーには標準ユーザーアクセストークンおよび管理者アクセストークンの 2 つのランタイムアクセストークンが割り当てられています。既定では、ユーザーは標準ユーザーロールに所属します。パフォーマンスカウンターにアクセスするコードを実行するには、まず特権を標準ユーザーから管理者に昇格させる必要があります。この操作は、アプリケーションの起動時にアプリケーションアイコンを右クリックし、管理者として実行することを指定して行うことができます。

こちらもご覧ください

PerformanceCounter

適用対象

GetCategories(String)

ソース:: PerformanceCounterCategory.cs

ソース:: PerformanceCounterCategory.cs

ソース:: PerformanceCounterCategory.cs

指定したコンピューターに登録されているパフォーマンスカウンターカテゴリの一覧を取得します。

public:
 static cli::array <System::Diagnostics::PerformanceCounterCategory ^> ^ GetCategories(System::String ^ machineName);

public static System.Diagnostics.PerformanceCounterCategory[] GetCategories (string machineName);

static member GetCategories : string -> System.Diagnostics.PerformanceCounterCategory[]

Public Shared Function GetCategories (machineName As String) As PerformanceCounterCategory()

パラメーター

machineName: String

検索対象のコンピューター。

戻り値

PerformanceCounterCategory[]

指定したコンピューターに登録されているカテゴリを指す PerformanceCounterCategory オブジェクトの配列。

例外

ArgumentException

machineName パラメーターが正しくありません。

Win32Exception

基になるシステム API の呼び出しに失敗しました。

UnauthorizedAccessException

管理特権を使用せずに実行されているコードがパフォーマンスカウンターの読み取りを試みました。

例

public:
    static void Main(array<String^>^ args)
    {
        String^ machineName = "";
        array<PerformanceCounterCategory^>^ categories;

        // Copy the machine name argument into the local variable.
        try
        {
            machineName = args[1]=="."? "": args[1];
        }
        catch (...)
        {
        }

        // Generate a list of categories registered on the specified computer.
        try
        {
            if (machineName->Length > 0)
            {
                categories = PerformanceCounterCategory::GetCategories(machineName);
            }
            else
            {
                categories = PerformanceCounterCategory::GetCategories();
            }
        }
        catch(Exception^ ex)
        {
            Console::WriteLine("Unable to get categories on " +
                (machineName->Length > 0 ? "computer \"{0}\":": "this computer:"), machineName);
            Console::WriteLine(ex->Message);
            return;
        }

        Console::WriteLine("These categories are registered on " +
            (machineName->Length > 0 ? "computer \"{0}\":": "this computer:"), machineName);

        // Create and sort an array of category names.
        array<String^>^ categoryNames = gcnew array<String^>(categories->Length);
        int objX;
        for (objX = 0; objX < categories->Length; objX++)
        {
            categoryNames[objX] = categories[objX]->CategoryName;
        }
        Array::Sort(categoryNames);

        for (objX = 0; objX < categories->Length; objX++)
        {
            Console::WriteLine("{0,4} - {1}", objX + 1, categoryNames[objX]);
        }
    }

public static void Main(string[] args)
{
    string machineName = "";
    PerformanceCounterCategory[] categories;

    // Copy the machine name argument into the local variable.
    try
    {
        machineName = args[0]=="."? "": args[0];
    }
    catch
    {
    }

    // Generate a list of categories registered on the specified computer.
    try
    {
        if (machineName.Length > 0)
        {
            categories = PerformanceCounterCategory.GetCategories(machineName);
        }
        else
        {
            categories = PerformanceCounterCategory.GetCategories();
        }
    }
    catch(Exception ex)
    {
        Console.WriteLine("Unable to get categories on " +
            (machineName.Length > 0 ? "computer \"{0}\":": "this computer:"), machineName);
        Console.WriteLine(ex.Message);
        return;
    }

    Console.WriteLine("These categories are registered on " +
        (machineName.Length > 0 ? "computer \"{0}\":": "this computer:"), machineName);

    // Create and sort an array of category names.
    string[] categoryNames = new string[categories.Length];
    int objX;
    for(objX = 0; objX < categories.Length; objX++)
    {
        categoryNames[objX] = categories[objX].CategoryName;
    }
    Array.Sort(categoryNames);

    for(objX = 0; objX < categories.Length; objX++)
    {
        Console.WriteLine("{0,4} - {1}", objX + 1, categoryNames[objX]);
    }
}

Sub Main(ByVal args() As String)
    Dim machineName As String = ""
    Dim categories() As PerformanceCounterCategory

    ' Copy the machine name argument into the local variable.
    Try
        machineName = IIf(args(0) = ".", "", args(0))
    Catch ex As Exception
    End Try

    ' Generate a list of categories registered on the specified computer.
    Try
        If machineName.Length > 0 Then
            categories = _
                PerformanceCounterCategory.GetCategories(machineName)
        Else
            categories = PerformanceCounterCategory.GetCategories()
        End If
    Catch ex As Exception
        Console.WriteLine("Unable to get categories on " & _
            IIf(machineName.Length > 0, "computer ""{0}"":", _
            "this computer:"), machineName)
        Console.WriteLine(ex.Message)
        Return
    End Try

    Console.WriteLine("These categories are registered on " & _
        IIf(machineName.Length > 0, _
            "computer ""{0}"":", "this computer:"), machineName)

    ' Create and sort an array of category names.
    Dim categoryNames(categories.Length - 1) As String
    Dim objX As Integer
    For objX = 0 To categories.Length - 1
        Console.WriteLine("{0}, {1}", objX, categories(objX).CategoryName)
        categoryNames(objX) = categories(objX).CategoryName
    Next objX
    Array.Sort(categoryNames)

    For objX = 0 To categories.Length - 1
        Console.WriteLine("{0,4} - {1}", objX + 1, categoryNames(objX))
    Next objX
End Sub

注釈

ローカルコンピューターでカテゴリを取得するには、別のオーバーロードを使用するか、パラメーターとして "." を machineName 渡します。

注意

こちらもご覧ください

PerformanceCounter

適用対象

次の方法で共有

PerformanceCounterCategory.GetCategories メソッド

定義

オーバーロード

GetCategories()

戻り値

例外

例

注釈

こちらもご覧ください

適用対象

GetCategories(String)

パラメーター

戻り値

例外

例

注釈

こちらもご覧ください

適用対象

その他のリソース