PerformanceCounter.CategoryName プロパティとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

PerformanceCounter.CategoryName プロパティ

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

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

Visual Basic (宣言)

Public Property CategoryName As
 String

Visual Basic (使用法)

Dim instance As PerformanceCounter
Dim value As String

value = instance.CategoryName

instance.CategoryName = value

public string CategoryName { get;
 set; }

C++

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

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

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

JScript

public function get CategoryName
 () : String

public function set CategoryName
 (value : String)

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

例外

例外の種類	条件
ArgumentNullException	CategoryName が null 参照 (Visual Basic では Nothing) です。
PlatformNotSupportedException	プラットフォームが Windows 98 または Windows Millennium Edition (Me) です。パフォーマンスカウンタはサポートされません。

解説

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

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

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

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

使用例

Visual Basic

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

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

C++

PerformanceCounter^ PC = gcnew PerformanceCounter;
PC->CategoryName = "Process";
PC->CounterName = "Private Bytes";
PC->InstanceName = "Explorer";
MessageBox::Show( PC->NextValue().ToString() );

PerformanceCounter pc = new PerformanceCounter();
pc.set_CategoryName("Process");
pc.set_CounterName("Private Bytes");
pc.set_InstanceName("Explorer");
MessageBox.Show(((Single)pc.NextValue()).ToString());