PerformanceCounter.CategoryName Vlastnost

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Diagnostics.PerformanceCounter.dll

Balíček:

System.Diagnostics.PerformanceCounter v8.0.0

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 tento čítač výkonu přidružen.

Výjimky

ArgumentNullException

Hodnota CategoryName je null.

Příklady

Následující příklad kódu vytvoří výchozí instanci PerformanceCounter třídy . Po vytvoření CategoryNameinstance jsou nastaveny hodnoty vlastností , CounterNamea InstanceName a zobrazí se NextValue výsledky volání metody.

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

Poznámky

Zobrazí CategoryName se v Performance Object poli dialogového okna snap in konzoly Add Counter MMC Správce čítače výkonu.

Čí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 seskupeny do kategorie, která označuje jejich společné zaměření. Při vytváření instance PerformanceCounter třídy nejprve označíte kategorii, se kterou bude komponenta komunikovat, a pak zvolíte čítač z této kategorie.

Jedna kategorie čítačů Windows je například kategorie Paměť. Systémové čítače v této kategorii sledují data paměti, například 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 ve vaší aplikaci, vytvořili byste instanci PerformanceCounter komponenty, připojili byste ji ke kategorii Paměť a pak byste z této kategorie vybrali příslušný čítač (v tomto případě Bajty 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 Mezipaměť, Paměť, Objekty, Fyzický disk, Proces, Procesor, Server, Systém a Vlákno.

Viz také

• ProcessName