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

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

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

PerformanceCounter.InstanceName プロパティ

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

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

Visual Basic (宣言)

Public Property InstanceName As
 String

Visual Basic (使用法)

Dim instance As PerformanceCounter
Dim value As String

value = instance.InstanceName

instance.InstanceName = value

public string InstanceName { get;
 set; }

C++

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

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

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

JScript

public function get InstanceName
 () : String

public function set InstanceName
 (value : String)

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

解説

メモ
インスタンス名は 128 文字未満であることが必要です。

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

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

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

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

メモ
インスタンス名には、"("、")"、"#"、"\"、"/" を使用しないでください。このいずれかの文字が使用されている場合、パフォーマンスコンソール (「ランタイムプロファイリング」を参照) でインスタンスの値が正しく表示されない可能性があります。

インスタンス名が自動的に生成されるときに、"("、")"、"#"、"\"、"/" のいずれかの文字が含まれる可能性がある場合、次の表に示す文字割り当てを使用します。

文字	割り当てられる文字
(	[
)	]
#	_
\	_
/	_

一般的に、無効な文字を含む可能性があるインスタンス名の原因となるのは、AppDomain.CurrentDomain プロパティから取得される AppDomain オブジェクトの FriendlyName プロパティです。

使用例

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