PerformanceCounter.InstanceName Proprietà

Definizione

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; }
[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; }
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string InstanceName { get; set; }
member this.InstanceName : string with get, set
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.InstanceName : string with get, set
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.InstanceName : string with get, set
[<System.ComponentModel.SettingsBindable(true)>]
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.InstanceName : string with get, set
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
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.

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 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 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 di istanza devono essere più brevi di 128 caratteri di lunghezza.

In alcune situazioni, le categorie vengono suddivise in istanze, che tengono traccia dei dati relativi a più occorrenze dell'oggetto a cui si riferisce 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 Process contiene istanze denominate Idle e System. Ogni contatore all'interno della categoria Processo contiene quindi dati per ogni istanza, che mostra informazioni sui processi inattive o sui processi di sistema.

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

Se questa PerformanceCounter istanza punta a una categoria noncustom, è possibile scegliere solo le istanze di categoria esistenti. È possibile creare nuove istanze di categoria solo nelle categorie personalizzate, che consentono di definire il numero di contatori e 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 vengono usati uno di questi caratteri, la Console prestazioni (vedere Profiling 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 ottenuta dalla AppDomain.CurrentDomain proprietà è un'origine AppDomain comune di nomi di istanza che possono contenere caratteri non validi.

Si applica a