PerformanceCounter.InstanceName-Eigenschaft

Artikel
08/20/2007

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

Namespace: System.Diagnostics
Assembly: System (in system.dll)

Syntax

'Declaration
Public Property InstanceName As String
'Usage
Dim instance As PerformanceCounter
Dim value As String

value = instance.InstanceName

instance.InstanceName = value

public string InstanceName { get; set; }

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

/** @property */
public String get_InstanceName ()

/** @property */
public void set_InstanceName (String value)

public function get InstanceName () : String

public function set InstanceName (value : String)

Eigenschaftenwert

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

Hinweise

Hinweis

Instanzennamen dürfen eine Länge von 128 Zeichen nicht überschreiten.

In einigen Fällen werden Kategorien in Instanzen unterteilt, mit denen Daten zum mehrfachen Vorkommen des Objekts verfolgt werden, mit dem eine Kategorie verknüpft ist. Instanzen beziehen sich nicht auf einzelne Zähler, sondern auf die gesamte Kategorie. Die Instanzen aller Zähler in einer Kategorie sind für die Kategorie definiert. Beispielsweise enthält die Kategorie Prozess die Instanzen Idle und System. Jeder Zähler der Kategorie Prozess enthält daher Daten für jede Instanz und zeigt Informationen zu Prozessen im Leerlauf oder zu Systemprozessen an.

Viele Kategorien enthalten nicht mehrere Instanzen, sodass Sie diese Eigenschaft leer lassen können, um anzuzeigen, dass der Kategorie keine Instanz zugeordnet ist.

Wenn diese PerformanceCounter-Instanz auf eine nicht benutzerdefinierte Kategorie zeigt, können Sie nur unter den vorhandenen Kategorieinstanzen auswählen. Neue Kategorieinstanzen können nur in benutzerdefinierten Kategorien erstellt werden. In benutzerdefinierten Kategorien können Sie beliebig viele Zähler und Kategorieinstanzen definieren.

Geben Sie zum Erstellen einer Instanz einer Leistungskategorie einen instanceName für den PerformanceCounter-Konstruktor an. Wenn die durch instanceName bezeichnete Kategorieinstanz bereits vorhanden ist, verweist das neue Objekt auf die vorhandene Kategorieinstanz.

Hinweis

Verwenden Sie im Instanznamen nicht die Zeichen "(", ")", "#", "\" oder "/". Wenn eines dieser Zeichen verwendet wird, werden die Instanzwerte in der Leistungskonsole (Laufzeit-Profilerstellung) möglicherweise nicht korrekt angezeigt.

Wenn der Instanzname automatisch generiert wird und möglicherweise die Zeichen "(", ")", "#", "\" oder "/" enthält, verwenden Sie die Zeichenzuordnung aus der folgenden Tabelle.

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

Die FriendlyName-Eigenschaft des AppDomain-Objekts, das aus der AppDomain.CurrentDomain-Eigenschaft abgerufen wird, ist eine allgemeine Quelle für Instanznamen, die möglicherweise ungültige Zeichen enthalten.

Beispiel

Dim PC As New 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());

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

PerformanceCounter pc = new PerformanceCounter();
pc.set_CategoryName("Process");
pc.set_CounterName("Private Bytes");
pc.set_InstanceName("Explorer");
MessageBox.Show(((Single)pc.NextValue()).ToString());

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

PerformanceCounter-Klasse
PerformanceCounter-Member
System.Diagnostics-Namespace

Freigeben über