PerformanceCounter.InstanceName Proprietà

Definizione

Spazio dei nomi:

System.Diagnostics

Assembly:

System.Diagnostics.PerformanceCounter.dll

Pacchetto:

System.Diagnostics.PerformanceCounter v8.0.0

Source:

PerformanceCounter.cs

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

public:
 property System::String ^ InstanceName { System::String ^ get(); void set(System::String ^ value); };

public string InstanceName { get; set; }

member this.InstanceName : string with get, set

Public Property InstanceName As String

Valore della proprietà

String

Il nome dell'istanza della categoria del contatore delle prestazioni, oppure una stringa vuota (""), se il contatore è un contatore con una sola istanza.

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

PerformanceCounter performanceCounter = new PerformanceCounter();
performanceCounter.CategoryName = "Process";
performanceCounter.CounterName = "Private Bytes";
performanceCounter.InstanceName = "Explorer";
MessageBox.Show(performanceCounter.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.

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.