PerformanceCounter.CategoryName プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
このパフォーマンス カウンターのパフォーマンス カウンター カテゴリの名前を取得または設定します。
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 スナップインの [Add Counter] ダイアログ ボックスの [Performance Object] フィールドに表示されます。
パフォーマンス カウンターは、コンピューター上のカテゴリまたはパフォーマンス オブジェクトの動作を監視します。 カテゴリには、物理コンポーネント (プロセッサ、ディスク、メモリなど) とシステム オブジェクト (プロセスやスレッドなど) が含まれます。 同じパフォーマンス オブジェクトに関連するシステム カウンターは、共通のフォーカスを示すカテゴリにグループ化されます。 PerformanceCounter クラスのインスタンスを作成するときは、まずコンポーネントが対話するカテゴリを指定してから、そのカテゴリからカウンターを選択します。
たとえば、1 つの Windows カウンター カテゴリがメモリ カテゴリです。 このカテゴリ内のシステム カウンターは、使用可能なバイト数やキャッシュされたバイト数などのメモリ データを追跡します。 アプリケーションにキャッシュされたバイトを操作する場合は、 PerformanceCounter コンポーネントのインスタンスを作成し、メモリ カテゴリに接続し、そのカテゴリから適切なカウンター (この場合はキャッシュされたバイト) を選択します。
システムではさらに多くのカウンター カテゴリを使用できますが、最も頻繁に操作するカテゴリは、キャッシュ、メモリ、オブジェクト、PhysicalDisk、Process、Processor、Server、System、および Thread カテゴリです。