PerformanceCounter.InstanceName Eigenschaft

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.PerformanceCounter.dll

Paket:

System.Diagnostics.PerformanceCounter v8.0.0

Quelle:

PerformanceCounter.cs

Ruft einen Instanznamen für diesen Leistungsindikator ab oder legt diesen fest.

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

Eigenschaftswert

String

Der Name der Instanz der Leistungsindikatorkategorie oder eine leere Zeichenfolge (""), wenn der Zähler ein Einzelinstanzzähler ist.

Beispiele

Im folgenden Codebeispiel wird eine Standard-instance der PerformanceCounter -Klasse erstellt. Nachdem die instance erstellt wurde, werden die CategoryNameEigenschaftswerte , CounterNameund InstanceName festgelegt, und die Ergebnisse eines Aufrufs der NextValue -Methode werden angezeigt.

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

Hinweise

Hinweis

Instanznamen müssen kürzer als 128 Zeichen sein.

In einigen Situationen werden Kategorien in Instanzen unterteilt, die Daten über mehrere Vorkommen des Objekts nachverfolgen, auf das sich eine Kategorie bezieht. Instanzen gelten für die Kategorie als Ganzes und nicht für einzelne Leistungsindikatoren. Für jeden Indikator innerhalb einer Kategorie ist jedes instance für die Kategorie definiert. Die Kategorie "Prozess" enthält z. B. Instanzen mit den Namen "Idle" und "System". Jeder Zähler innerhalb der Kategorie Prozess enthält somit Daten für jeden instance und zeigt Informationen zu Leerlauf- oder Systemprozessen an.

Viele Kategorien enthalten nicht mehrere Instanzen, sodass Sie diese Eigenschaft leer lassen können, um anzugeben, dass der Kategorie kein instance zugeordnet ist.

Wenn diese PerformanceCounter instance auf eine nicht benutzerdefinierte Kategorie verweist, können Sie nur aus den vorhandenen Kategorieinstanzen auswählen. Sie können neue Kategorieinstanzen nur in benutzerdefinierten Kategorien erstellen, mit denen Sie so viele Indikatoren und Kategorieinstanzen definieren können, wie Sie benötigen.

Um eine Leistungskategorie instance zu erstellen, geben Sie eine für den PerformanceCounter Konstruktor aninstanceName. Wenn die von instanceName angegebene Kategorie instance bereits vorhanden ist, verweist das neue Objekt auf die vorhandene Kategorie instance.

Hinweis

Verwenden Sie nicht die Zeichen "(", ")", "#", "\" oder "/" im instance Namen. Wenn eines dieser Zeichen verwendet wird, zeigt die Leistungskonsole (siehe Laufzeitprofilerstellung) die instance Werte möglicherweise nicht ordnungsgemäß an.

Wenn der instance Name automatisch generiert wird und die Zeichen "(", ")", "#", "\" oder "/" enthalten kann, verwenden Sie die Zeichenzuordnung in der folgenden Tabelle.

Zeichen	Zugeordnetes Zeichen
(	[
)	]
#	_
\	_
/	_

Die FriendlyName -Eigenschaft des -Objekts, das AppDomain aus der AppDomain.CurrentDomain -Eigenschaft abgerufen wird, ist eine häufige Quelle für instance Namen, die ungültige Zeichen enthalten können.