PerformanceCounter.CategoryName Eigenschaft

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.PerformanceCounter.dll

Paket:

System.Diagnostics.PerformanceCounter v8.0.0

Quelle:

PerformanceCounter.cs

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; }

member this.CategoryName : string with get, set

Public Property CategoryName As String

Eigenschaftswert

String

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

Ausnahmen

ArgumentNullException

CategoryName ist null.

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

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 instance 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 instance der PerformanceCounter Komponente, verbinden sie mit der Kategorie Arbeitsspeicher, und wählen Sie dann den entsprechenden Leistungsindikator (in diesem Fall zwischengespeicherte Bytes) aus dieser Kategorie aus.

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

Weitere Informationen

• ProcessName