PerformanceCounter.CategoryName Vlastnost

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Diagnostics.PerformanceCounter.dll

Zdroj:

PerformanceCounter.cs

Získá nebo nastaví název kategorie čítače výkonu pro tento čítač výkonu.

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

Hodnota vlastnosti

String

Název kategorie čítače výkonu (objekt výkonu), ke které je přidružen tento čítač výkonu.

Výjimky

ArgumentNullException

To CategoryName je null.

Příklady

Následující příklad kódu vytvoří výchozí instanci PerformanceCounter třídy. Po vytvoření instance jsou nastaveny CategoryNamehodnoty , CounterNamea InstanceName vlastnosti a výsledky volání NextValue metody jsou zobrazeny.

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

Poznámky

Zobrazí se CategoryName v Performance Object poli modulu snap-in konzoly MMC Správce čítače výkonu Add Counter .

Čítač výkonu monitoruje chování kategorie nebo objektu výkonu v počítači. Kategorie zahrnují fyzické komponenty (například procesory, disky a paměť) a systémové objekty (například procesy a vlákna). Systémové čítače, které souvisejí se stejným objektem výkonu, jsou seskupené do kategorie, která označuje jejich společný fokus. Při vytváření instance PerformanceCounter třídy nejprve označíte kategorii, se kterou bude komponenta pracovat, a pak zvolíte čítač z této kategorie.

Například jedna kategorie čítače Windows je kategorie Paměť. Čítače systému v této kategorii sledují data paměti, jako je počet dostupných bajtů a počet bajtů uložených v mezipaměti. Pokud byste chtěli pracovat s bajty uloženými v mezipaměti vaší aplikace, vytvořili byste instanci PerformanceCounter komponenty, připojili ji k kategorii Paměť a pak z této kategorie vybrali příslušný čítač (v tomto případě bytes uložený v mezipaměti).

I když váš systém zpřístupňuje mnoho dalších kategorií čítačů, kategorie, se kterými budete pravděpodobně pracovat nejčastěji, jsou kategorie Cache, Memory, Objects, PhysicalDisk, Process, Processor, Server, System a Thread kategorie.

Viz také

• ProcessName