PerformanceCounter.CategoryName Eigenschaft

Definition

Ruft den Namen der Leistungsindikatorkategorie für diesen Leistungsindikator ab oder legt diesen fest.

public:
 property System::String ^ CategoryName { System::String ^ get(); void set(System::String ^ value); };
public string CategoryName { get; set; }
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.CategoryValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string CategoryName { get; set; }
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.CategoryValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string CategoryName { get; set; }
[System.ComponentModel.SettingsBindable(true)]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.CategoryValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string CategoryName { get; set; }
member this.CategoryName : string with get, set
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.CategoryValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.CategoryName : string with get, set
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.CategoryValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.CategoryName : string with get, set
[<System.ComponentModel.SettingsBindable(true)>]
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.CategoryValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.CategoryName : string with get, set
Public Property CategoryName As String

Eigenschaftswert

Der Name der Leistungsindikatorkategorie (bzw. des Leistungsobjekts), der dieser Leistungsindikator zugeordnet ist.

Attribute

Ausnahmen

Beispiele

Im folgenden Codebeispiel wird eine Standardinstanz der PerformanceCounter -Klasse erstellt. Nachdem die -Instanz 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

Wird CategoryName im Feld des Performance Object Mmc-Snap-Ins des Leistungsindikator-Managers Add Counter angezeigt.

Ein Leistungsindikator überwacht das Verhalten einer Kategorie oder eines Leistungsobjekts auf einem Computer. Zu den Kategorien gehören physische Komponenten (z. B. Prozessoren, Datenträger und Arbeitsspeicher) und Systemobjekte (z. B. Prozesse und Threads). Systemindikatoren, die sich auf dasselbe Leistungsobjekt beziehen, werden in einer Kategorie gruppiert, die ihren gemeinsamen Fokus angibt. Wenn Sie eine Instanz der PerformanceCounter -Klasse erstellen, geben Sie zunächst die Kategorie an, mit der die Komponente interagiert, und wählen dann einen Zähler aus dieser Kategorie aus.

Eine Windows-Leistungsindikatorkategorie ist z. B. die Kategorie "Arbeitsspeicher". Systemindikatoren innerhalb dieser Kategorie verfolgen Speicherdaten, z. B. die Anzahl der verfügbaren Bytes und die Anzahl der zwischengespeicherten Bytes. Wenn Sie mit den in Ihrer Anwendung zwischengespeicherten Bytes arbeiten möchten, erstellen Sie eine Instanz der PerformanceCounter Komponente, verbinden sie mit der Kategorie Arbeitsspeicher und wählen dann den entsprechenden Leistungsindikator (in diesem Fall zwischengespeicherte Bytes) aus dieser Kategorie aus.

Obwohl Ihr System viele weitere Indikatorenkategorien zur Verfügung stellt, sind die Kategorien Cache, Arbeitsspeicher, Objekte, PhysicalDisk, Prozess, Prozessor, Server, System und Thread die Kategorien, mit denen Sie wahrscheinlich am häufigsten interagieren werden.

Gilt für:

Weitere Informationen