PerformanceCounter.InstanceName Proprietà

Definizione

Ottiene o imposta un nome di istanza per questo contatore delle prestazioni.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

Valore della proprietà

Il nome dell'istanza della categoria del contatore delle prestazioni, oppure una stringa vuota (""), se il contatore è un contatore con una sola istanza.The name of the performance counter category instance, or an empty string (""), if the counter is a single-instance counter.

Attributi

Esempi

Nell'esempio di codice seguente viene creata un'istanza predefinita della classe PerformanceCounter.The following code example creates a default instance of the PerformanceCounter class. Una volta creata l'istanza, vengono impostati i valori delle proprietà CategoryName, CounterName e InstanceName e vengono visualizzati i risultati di una chiamata al metodo 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())

Commenti

Nota

I nomi delle istanze devono avere una lunghezza inferiore a 128 caratteri.Instance names must be shorter than 128 characters in length.

In alcune situazioni, le categorie sono suddivise in istanze, che tengono traccia dei dati relativi a più occorrenze dell'oggetto a cui è correlata una categoria.In some situations, categories are subdivided into instances, which track data about multiple occurrences of the object that a category relates to. Le istanze di vengono applicate alla categoria come intero, anziché ai singoli contatori.Instances apply to the category as whole, rather than to individual counters. Ogni contatore all'interno di una categoria dispone di ogni istanza definita per la categoria.Every counter within a category has each instance defined for the category. Ad esempio, la categoria del processo contiene le istanze denominate inattive e di sistema.For example, the Process category contains instances named Idle and System. Ogni contatore all'interno della categoria Process contiene quindi i dati per ogni istanza, mostrando informazioni sui processi inattivi o sui processi di sistema.Every counter within the Process category thus contains data for each instance, showing information about either idle processes or system processes.

Molte categorie non contengono più istanze, pertanto è possibile lasciare vuota questa proprietà per indicare che alla categoria non è associata alcuna istanza.Many categories do not contain multiple instances, so you can leave this property empty to indicate that no instance is associated with the category.

Se questa istanza PerformanceCounter punta a una categoria non personalizzata, è possibile scegliere solo tra le istanze di categoria esistenti.If this PerformanceCounter instance points to a noncustom category, you can choose from only the existing category instances. È possibile creare nuove istanze di categoria solo in categorie personalizzate, che consentono di definire il numero di contatori e istanze di categoria necessari.You can create new category instances only in custom categories, which allow you to define as many counters and category instances as you need.

Per creare un'istanza di categoria prestazioni, specificare un instanceName nel costruttore PerformanceCounter.To create a performance category instance, specify an instanceName on the PerformanceCounter constructor. Se l'istanza di categoria specificata da instanceName esiste già, il nuovo oggetto fa riferimento all'istanza di categoria esistente.If the category instance specified by instanceName already exists the new object will reference the existing category instance.

Nota

Non usare i caratteri "(", ")", "#", "\" o "/" nel nome dell'istanza.Do not use the characters "(", ")", "#", "\", or "/" in the instance name. Se viene usato uno di questi caratteri, la console prestazioni (vedere Profilatura runtime) potrebbe non visualizzare correttamente i valori dell'istanza.If any of these characters are used, the Performance Console (see Runtime Profiling) may not correctly display the instance values.

Se il nome dell'istanza viene generato automaticamente e può contenere i caratteri "(", ")", "#", "\" o "/", utilizzare il mapping dei caratteri nella tabella seguente.If the instance name is automatically generated and might contain the characters "(", ")", "#", "\", or "/", use the character mapping in the following table.

CarattereCharacter Carattere mappatoMapped character
(( [[
)) ]]
#
||
/

La proprietà FriendlyName dell'oggetto AppDomain ottenuto dalla proprietà AppDomain.CurrentDomain è un'origine comune dei nomi di istanza che possono contenere caratteri non validi.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.

Si applica a