PerformanceCounter.InstanceName プロパティ

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

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

プロパティ値

パフォーマンス カウンタ カテゴリ インスタンスの名前。単一インスタンス カウンタの場合は空の文字列 ("")。

解説

場合によっては、カテゴリがインスタンスに再分割されることがあります。インスタンスは、カテゴリに関連するオブジェクトの複数の出現に関するデータを追跡します。インスタンスは、個別のカウンタではなく、カテゴリ全体に適用されます。カテゴリ内のすべてのカウンタのそれぞれに、カテゴリに定義されたインスタンスがあります。たとえば、Process カテゴリには、Idle および System という名前のインスタンスがあります。そのため、Process カテゴリ内の各カウンタには、各インスタンスのデータが格納され、アイドル プロセスまたはシステム プロセスに関する情報が表示されます。

複数のインスタンスが含まれるカテゴリは多くありません。そのため、このプロパティを空のままにして、カテゴリに関連付けられているインスタンスがないことを示すことができます。

この PerformanceCounter インスタンスが非カスタム カテゴリを指す場合、選択できる対象は既存のカテゴリ インスタンスだけです。新しいカテゴリ インスタンスを作成できるのは、カスタム カテゴリだけです。カスタム カテゴリによって、必要な数のカウンタとカテゴリ インスタンスを定義できます。

パフォーマンス カテゴリ インスタンスを作成するには、 PerformanceCounter コンストラクタで instanceName を指定します。 instanceName で指定されたカテゴリ インスタンスが既に存在する場合、新しいオブジェクトは既存のカテゴリ インスタンスを参照します。

使用例

 
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 名前空間