PerformanceCounter.InstanceName Egenskap

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

Egenskapsvärde

Namnet på prestandaräknarens kategoriinstans eller en tom sträng (""), om räknaren är en räknare med en instans.

Attribut

TypeConverterAttribute SettingsBindableAttribute

Exempel

I följande kodexempel skapas en standardinstans av PerformanceCounter klassen. När instansen har skapats CategoryNameanges egenskapsvärdena , CounterNameoch och InstanceName resultatet av ett anrop till NextValue metoden visas.

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())

Kommentarer

I vissa situationer delas kategorier in i instanser, som spårar data om flera förekomster av objektet som en kategori relaterar till. Instanser gäller för kategorin som helhet i stället för enskilda räknare. Varje räknare i en kategori har varje instans definierad för kategorin. Kategorin Process innehåller till exempel instanser med namnet Inaktiv och System. Varje räknare i kategorin Process innehåller därför data för varje instans som visar information om inaktiva processer eller systemprocesser.

Många kategorier innehåller inte flera instanser, så du kan lämna den här egenskapen tom för att indikera att ingen instans är associerad med kategorin.

Om den här PerformanceCounter instansen pekar på en icke-anpassad kategori kan du bara välja bland de befintliga kategoriinstanserna. Du kan bara skapa nya kategoriinstanser i anpassade kategorier, vilket gör att du kan definiera så många räknare och kategoriinstanser som du behöver.

Om du vill skapa en instans av prestandakategori anger du en instanceName på PerformanceCounter konstruktorn. Om kategoriinstansen som anges av instanceName redan finns refererar det nya objektet till den befintliga kategoriinstansen.

Om instansnamnet genereras automatiskt och kan innehålla tecknen "(", ")", "#", "\" eller "/", använder du teckenmappningen i följande tabell.

Egenskapen FriendlyName för objektet AppDomain som hämtas från AppDomain.CurrentDomain egenskapen är en vanlig källa till instansnamn som kan innehålla ogiltiga tecken.