PerformanceCounter.InstanceName Proprietà

Definizione

Ottiene o imposta un nome di istanza per questo contatore delle prestazioni.

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; }

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.

Attributi

Esempio

Nell'esempio di codice seguente viene creata un'istanza predefinita della PerformanceCounter classe . Dopo aver creato l'istanza, vengono impostati i valori delle CategoryNameproprietà , CounterNamee InstanceName e i risultati di una chiamata al NextValue metodo vengono visualizzati.

PerformanceCounter performanceCounter = new PerformanceCounter();
performanceCounter.CategoryName = "Process";
performanceCounter.CounterName = "Private Bytes";
performanceCounter.InstanceName = "Explorer";
MessageBox.Show(performanceCounter.NextValue().ToString());

Commenti

Nota

I nomi delle istanze devono avere una lunghezza inferiore a 128 caratteri.

In alcune situazioni, le categorie vengono suddivise in istanze, che tengono traccia dei dati relativi a più occorrenze dell'oggetto a cui è correlata una categoria. Le istanze si applicano alla categoria nel suo complesso, anziché ai singoli contatori. Ogni contatore all'interno di una categoria ha ogni istanza definita per la categoria. Ad esempio, la categoria Processo contiene istanze denominate Idle e System. Ogni contatore all'interno della categoria Processo contiene quindi dati per ogni istanza, che mostrano informazioni sui processi inattici o sui processi di sistema.

Molte categorie non contengono più istanze, pertanto è possibile lasciare vuota questa proprietà per indicare che nessuna istanza è associata alla categoria.

Se questa PerformanceCounter istanza punta a una categoria non personalizzata, è possibile scegliere solo tra le istanze di categoria esistenti. È possibile creare nuove istanze di categoria solo in categorie personalizzate, che consentono di definire tutti i contatori e le istanze di categoria necessarie.

Per creare un'istanza della categoria di prestazioni, specificare un instanceName oggetto nel PerformanceCounter costruttore . Se l'istanza di categoria specificata da instanceName esiste già, il nuovo oggetto farà riferimento all'istanza di categoria esistente.

Nota

Non usare i caratteri "(", ")", "#", "\" o "/" nel nome dell'istanza. Se si utilizza uno di questi caratteri, la Console prestazioni (vedere Profiling di runtime) potrebbe non visualizzare correttamente i valori dell'istanza.

Se il nome dell'istanza viene generato automaticamente e può contenere i caratteri "(", ")", "#", "\" o "/", usare il mapping dei caratteri nella tabella seguente.

Carattere Carattere mappato
( [
) ]
# _
\ _
/ _

La FriendlyName proprietà dell'oggetto ottenuto dalla AppDomain.CurrentDomain proprietà è un'origine AppDomain comune di nomi di istanza che possono contenere caratteri non validi.

Si applica a

Prodotto Versioni
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9