PerformanceCounter.InstanceName PerformanceCounter.InstanceName PerformanceCounter.InstanceName PerformanceCounter.InstanceName Property

정의

이 성능 카운터에 대한 인스턴스 이름을 가져오거나 설정합니다.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. 인스턴스가 만들어진 후 합니다 CategoryName, CounterName, 및 InstanceName 속성 값은 집합 및에 대 한 호출의 결과 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. 예를 들어 프로세스 범주 유휴 상태 및 시스템을 명명 된 인스턴스를 포함 합니다.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.

이 경우 PerformanceCounter 인스턴스 비 사용자 정의 범주를 지점에서 기존 범주 인스턴스만 선택할 수 있습니다.If this PerformanceCounter instance points to a noncustom category, you can choose from only the existing category instances. 인스턴스를 정의할 수 카운터 범주와 필요에 따라 할 수 있는 사용자 지정 범주에만 새 범주 인스턴스를 만들 수 있습니다.You can create new category instances only in custom categories, which allow you to define as many counters and category instances as you need.

성능 범주 인스턴스를 만들려면 지정는 instanceNamePerformanceCounter 생성자입니다.To create a performance category instance, specify an instanceName on the PerformanceCounter constructor. 으로 지정 된 범주 인스턴스 instanceName 이미 새 개체는 기존 범주 인스턴스를 참조 합니다.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
(( [[
)) ]]
#
||
/

FriendlyName 의 속성을 AppDomain 개체에서 가져온는 AppDomain.CurrentDomain 속성이 잘못 된 문자를 포함할 수 있는 인스턴스 이름의 공용 원본.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.

적용 대상