PerformanceCounter.InstanceName プロパティ

定義

このパフォーマンス カウンターのインスタンス名を取得または設定します。Gets or sets an instance name for this performance counter.

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

プロパティ値

パフォーマンス カウンター カテゴリ インスタンスの名前。単一インスタンス カウンターの場合は空の文字列 ("")。The name of the performance counter category instance, or an empty string (""), if the counter is a single-instance counter.

属性

次のコード例では、PerformanceCounter クラスの既定のインスタンスを作成します。The following code example creates a default instance of the PerformanceCounter class. インスタンスが作成されると、CategoryNameCounterNameInstanceName の各プロパティ値が設定され、NextValue メソッドの呼び出しの結果が表示されます。After the instance is created, the CategoryName, CounterName, and InstanceName property values are set, and the results of a call to the NextValue method are displayed.

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文字未満でなければなりません。Instance names must be shorter than 128 characters in length.

場合によっては、カテゴリがインスタンスに分割され、カテゴリが関連付けられているオブジェクトの複数の発生に関するデータを追跡します。In some situations, categories are subdivided into instances, which track data about multiple occurrences of the object that a category relates to. インスタンスは、個々のカウンターではなく、全体としてカテゴリに適用されます。Instances apply to the category as whole, rather than to individual counters. カテゴリ内のすべてのカウンターには、カテゴリに対して定義されている各インスタンスがあります。Every counter within a category has each instance defined for the category. たとえば、Process カテゴリには、Idle および System という名前のインスタンスが含まれます。For example, the Process category contains instances named Idle and System. このため、プロセスカテゴリ内のすべてのカウンターには、各インスタンスのデータが含まれ、アイドル状態のプロセスまたはシステムプロセスに関する情報が表示されます。Every counter within the Process category thus contains data for each instance, showing information about either idle processes or system processes.

多くのカテゴリには複数のインスタンスが含まれていないため、このプロパティを空のままにして、インスタンスがカテゴリに関連付けられていないことを示すことができます。Many categories do not contain multiple instances, so you can leave this property empty to indicate that no instance is associated with the category.

この @no__t 0 のインスタンスがカスタムカテゴリを指している場合は、既存のカテゴリインスタンスからのみ選択できます。If this PerformanceCounter instance points to a noncustom category, you can choose from only the existing category instances. 新しい category インスタンスはカスタムカテゴリにのみ作成できます。これにより、必要な数のカウンターおよびカテゴリインスタンスを定義できます。You can create new category instances only in custom categories, which allow you to define as many counters and category instances as you need.

パフォーマンスカテゴリのインスタンスを作成するには、PerformanceCounter コンストラクターに instanceName を指定します。To create a performance category instance, specify an instanceName on the PerformanceCounter constructor. @No__t-0 によって指定されたカテゴリインスタンスが既に存在する場合、新しいオブジェクトは既存の category インスタンスを参照します。If the category instance specified by instanceName already exists the new object will reference the existing category instance.

注意

インスタンス名には、"("、")"、"#"、"\"、"/" の文字は使用しないでください。Do not use the characters "(", ")", "#", "\", or "/" in the instance name. これらの文字のいずれかが使用されている場合、パフォーマンスコンソール (「ランタイムプロファイリング」を参照) によってインスタンス値が正しく表示されないことがあります。If any of these characters are used, the Performance Console (see Runtime Profiling) may not correctly display the instance values.

インスタンス名が自動的に生成され、文字 "(", ")"、"#"、"\"、"/" が含まれている可能性がある場合は、次の表の文字マッピングを使用します。If the instance name is automatically generated and might contain the characters "(", ")", "#", "\", or "/", use the character mapping in the following table.

文字Character マップされた文字Mapped character
(( [[
)) ]]
#
||
/

@No__t-2 プロパティから取得された AppDomain オブジェクトの @no__t 0 プロパティは、無効な文字を含む可能性があるインスタンス名の共通ソースです。The FriendlyName property of the AppDomain object obtained from the AppDomain.CurrentDomain property is a common source of instance names that can contain invalid characters.

適用対象