PerformanceCounter.CategoryName Eigenschaft

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.PerformanceCounter.dll

Quelle:

PerformanceCounter.cs

Dient zum Abrufen oder Festlegen des Namens der Leistungsindikatorkategorie für diesen Leistungsindikator.

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 (Leistungsobjekt), der dieser Leistungsindikator zugeordnet ist.

Ausnahmen

ArgumentNullException

CategoryName ist null.

Beispiele

Im folgenden Codebeispiel wird eine Standardinstanz der PerformanceCounter Klasse erstellt. Nachdem die Instanz erstellt wurde, werden die CategoryNameWerte CounterNameund InstanceName Eigenschaftswerte festgelegt, und die Ergebnisse eines Aufrufs der NextValue Methode werden angezeigt.

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

Dies CategoryName wird im Performance Object Feld des MMC-Snap-Ins des Leistungsindikator-Managers Add Counter angezeigt.

Ein Leistungsindikator überwacht das Verhalten einer Kategorie oder eines Leistungsobjekts auf einem Computer. Kategorien umfassen physische Komponenten (z. B. Prozessoren, Datenträger und Arbeitsspeicher) und Systemobjekte (z. B. Prozesse und Threads). Systemzähler, 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 zuerst die Kategorie an, mit der die Komponente interagiert, und wählen Sie dann einen Zähler aus dieser Kategorie aus.

Beispielsweise ist eine Windows-Leistungsindikatorkategorie die Kategorie "Arbeitsspeicher". Systemzähler in 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 "Speicher", und wählen Sie dann den entsprechenden Zähler (in diesem Fall "Zwischengespeicherte Bytes") aus dieser Kategorie aus.

Obwohl Ihr System viele weitere Leistungskategorien zur Verfügung stellt, sind die Kategorien, mit denen Sie wahrscheinlich am häufigsten interagieren, die Kategorien "Cache", "Memory", "Objects", "PhysicalDisk", "Process", "Processor", "Server", "System" und "Thread".

Weitere Informationen

• ProcessName