PerformanceCounter.InstanceName プロパティ

定義

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

public:
 property System::String ^ InstanceName { System::String ^ get(); void set(System::String ^ value); };
public string InstanceName { get; set; }
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string InstanceName { get; set; }
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string InstanceName { get; set; }
[System.ComponentModel.SettingsBindable(true)]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string InstanceName { get; set; }
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string InstanceName { get; set; }
member this.InstanceName : string with get, set
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.InstanceName : string with get, set
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.InstanceName : string with get, set
[<System.ComponentModel.SettingsBindable(true)>]
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.InstanceName : string with get, set
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.InstanceName : string with get, set
Public Property InstanceName As String

プロパティ値

String

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

属性

次のコード例では、クラスの既定のインスタンスを PerformanceCounter 作成します。 インスタンスが作成されると、CategoryName,,およびInstanceNameプロパティの値が設定され、メソッドのNextValue呼び出しの結果CounterNameが表示されます。

PerformanceCounter^ PC = gcnew 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());
Dim PC As New PerformanceCounter()
PC.CategoryName = "Process"
PC.CounterName = "Private Bytes"
PC.InstanceName = "Explorer"
MessageBox.Show(PC.NextValue().ToString())

注釈

注意

インスタンス名の長さは 128 文字未満にする必要があります。

状況によっては、カテゴリがインスタンスに分割され、カテゴリが関連するオブジェクトの複数の出現に関するデータが追跡されます。 インスタンスは、個々のカウンターではなく、カテゴリ全体に適用されます。 カテゴリ内のすべてのカウンターには、カテゴリに対して定義された各インスタンスがあります。 たとえば、プロセス カテゴリには、Idle と System という名前のインスタンスが含まれています。 プロセス カテゴリ内のすべてのカウンターには、アイドル状態のプロセスまたはシステム プロセスに関する情報を示す各インスタンスのデータが含まれます。

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

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

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

注意

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

インスタンス名が自動的に生成され、文字 "("、")"、"#"、""、または "/" が\含まれている可能性がある場合は、次の表の文字マッピングを使用します。

文字 マップされた文字
( [
) ]
# _
\ _
/ _

プロパティからAppDomain.CurrentDomain取得されたオブジェクトのAppDomainプロパティはFriendlyName、無効な文字を含むことができるインスタンス名の一般的なソースです。

適用対象