Language

PerformanceCounter.CategoryName プロパティ

定義

このパフォーマンス カウンターのパフォーマンス カウンター カテゴリの名前を取得または設定します。

public:
 property System::String ^ CategoryName { System::String ^ get(); void set(System::String ^ value); };
public string CategoryName { get; set; }
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.CategoryValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string CategoryName { get; set; }
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.CategoryValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string CategoryName { get; set; }
[System.ComponentModel.SettingsBindable(true)]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.CategoryValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string CategoryName { get; set; }
member this.CategoryName : string with get, set
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.CategoryValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.CategoryName : string with get, set
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.CategoryValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.CategoryName : string with get, set
[<System.ComponentModel.SettingsBindable(true)>]
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.CategoryValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.CategoryName : string with get, set
Public Property CategoryName As String

プロパティ値

このパフォーマンス カウンターが関連付けられているパフォーマンス カウンター カテゴリ (パフォーマンス オブジェクト) の名前。

属性

例外

CategoryName は null です。

例

次のコード例では、 PerformanceCounter クラスの既定のインスタンスを作成します。 インスタンスが作成されると、 CategoryName、 CounterName、および InstanceName プロパティの値が設定され、 NextValue メソッドの呼び出しの結果が表示されます。

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())

注釈

CategoryNameは、パフォーマンス カウンター マネージャー MMC スナップインの [Performance Object] ダイアログ ボックスの [Add Counter] フィールドに表示されます。

パフォーマンス カウンターは、コンピューター上のカテゴリまたはパフォーマンス オブジェクトの動作を監視します。 カテゴリには、物理コンポーネント (プロセッサ、ディスク、メモリなど) とシステム オブジェクト (プロセスやスレッドなど) が含まれます。 同じパフォーマンス オブジェクトに関連するシステム カウンターは、共通のフォーカスを示すカテゴリにグループ化されます。 PerformanceCounter クラスのインスタンスを作成するときは、まずコンポーネントが対話するカテゴリを指定してから、そのカテゴリからカウンターを選択します。

たとえば、1 つの Windows カウンター カテゴリがメモリ カテゴリです。 このカテゴリ内のシステム カウンターは、使用可能なバイト数やキャッシュされたバイト数などのメモリ データを追跡します。 アプリケーションにキャッシュされたバイトを操作する場合は、 PerformanceCounter コンポーネントのインスタンスを作成し、メモリ カテゴリに接続し、そのカテゴリから適切なカウンター (この場合はキャッシュされたバイト) を選択します。

システムではさらに多くのカウンター カテゴリを使用できますが、最も頻繁に操作するカテゴリは、キャッシュ、メモリ、オブジェクト、PhysicalDisk、Process、Processor、Server、System、および Thread カテゴリです。

適用対象

こちらもご覧ください