PerformanceCounter.InstanceName Proprietà
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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; }
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
Public Property InstanceName As 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
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())
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.
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 |
Feedback su .NET
.NET è un progetto di open source. Selezionare un collegamento per fornire feedback: