Share via

PerformanceCounter.CategoryName プロパティ

  • [アーティクル]

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

Public Property CategoryName As String
[C#]
public string CategoryName {get; set;}
[C++]
public: __property String* get_CategoryName();public: __property void set_CategoryName(String*);
[JScript]
public function get CategoryName() : String;public function set CategoryName(String);

プロパティ値

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

例外

例外の種類 条件
ArgumentNullException CategoryName が null 参照 (Visual Basic では Nothing) です。

解説

CategoryName は、パフォーマンス カウンタ マネージャ MMC スナップインの [ カウンタの追加] ダイアログ ボックスの [ パフォーマンス オブジェクト] ボックスに表示されます。

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

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

システムで利用できるカウンタ カテゴリは多数ありますが、頻繁にやり取りするカテゴリは、Cache、Memory、Objects、PhysicalDisk、Process、Processor、Server、System、および Thread です。

使用例

 
Dim PC As New PerformanceCounter()
PC.CategoryName = "Process"
PC.CounterName = "Private Bytes"
PC.InstanceName = "Explorer"
MessageBox.Show(PC.NextValue().ToString())

[C#] 
PerformanceCounter PC=new PerformanceCounter();
PC.CategoryName="Process";
PC.CounterName="Private Bytes";
PC.InstanceName="Explorer";
MessageBox.Show(PC.NextValue().ToString());

[C++] 
PerformanceCounter* PC = new PerformanceCounter();
PC->CategoryName=S"Process";
PC->CounterName=S"Private Bytes";
PC->InstanceName=S"Explorer";
MessageBox::Show(PC->NextValue().ToString());

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン 言語のフィルタ をクリックします。

必要条件

プラットフォーム: Windows NT Server 4.0, Windows NT Workstation 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

PerformanceCounter クラス | PerformanceCounter メンバ | System.Diagnostics 名前空間 | Process.ProcessName