PerformanceCounterCategory.CategoryName プロパティ

.NET Framework クラス ライブラリ リファレンス

PerformanceCounterCategory.CategoryName プロパティ

このカテゴリを定義するパフォーマンス オブジェクト名を取得または設定します。

名前空間: System.Diagnostics
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Property CategoryName As
 String

Visual Basic (使用法)

Dim instance As PerformanceCounterCategory
Dim value As String

value = instance.CategoryName

instance.CategoryName = value

C#

public string CategoryName { get;
 set; }

C++

public:
property String^ CategoryName {
    String^ get ();
    void set (String^ value);
}

J#

/** @property */
public String get_CategoryName ()

/** @property */
public void set_CategoryName (String value)

JScript

public function get CategoryName
 () : String

public function set CategoryName
 (value : String)

プロパティ値
この PerformanceCounterCategory インスタンスを関連付けるパフォーマンス カウンタ カテゴリまたはパフォーマンス オブジェクトの名前。

例外

例外の種類	条件
ArgumentException	CategoryName が空の文字列 ("") です。
ArgumentNullException	CategoryName が null 参照 (Visual Basic では Nothing) です。

使用例

PerformanceCounterCategory で PerformanceCounterCategory を作成するコード例を次に示します。PerformanceCounterCategory およびコンピュータ名を入力するよう求めるメッセージを表示し、入力された値を使用して CategoryName プロパティおよび MachineName プロパティを設定します。次に、CategoryName、MachineName、および CategoryHelp の各プロパティの値を表示します。また、PerformanceCounterCategory にアクセスできない場合はエラー メッセージを表示します。

Visual Basic

Sub Main(ByVal args() As
 String)
    Dim categoryName As String
 = ""
    Dim machineName As String
 = ""
    Dim pcc As New PerformanceCounterCategory

    ' Prompt for fields and set the corresponding properties.
    While categoryName.Length = 0
        Console.Write("Please enter a non-blank category name:
 ")
        categoryName = Console.ReadLine().Trim
        If categoryName.Length > 0 Then
            pcc.CategoryName = categoryName
        End If
    End While
    While machineName.Length = 0
        Console.Write( _
            "Enter a non-blank computer name ['.' for local]: ")
        machineName = Console.ReadLine().Trim
        If machineName.Length > 0 Then
            pcc.MachineName = machineName
        End If
    End While

    ' Display the properties of the PerformanceCounterCategory object.
    Try
        Console.WriteLine("  Category:  {0}", pcc.CategoryName)
        Console.WriteLine("  Computer:  {0}", pcc.MachineName)
        Console.WriteLine("  Help text: {0}", pcc.CategoryHelp)
    Catch ex As Exception
        Console.WriteLine("Error getting the properties of the
 " & _
            "PerformanceCounterCategory object:")
        Console.WriteLine(ex.Message)
    End Try
End Sub

.NET Framework のセキュリティ

• PerformanceCounterPermissionAccess  (パフォーマンス カウンタ カテゴリを読み取るために必要なアクセス許可)。PerformanceCounterPermissionAccess.Read (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
PerformanceCounterCategory クラス
PerformanceCounterCategory メンバ
System.Diagnostics 名前空間
MachineName
PerformanceCounter クラス