Condividi tramite


PerformanceCounter.CategoryName Proprietà

Definizione

Ottiene o imposta il nome della categoria del contatore delle prestazioni di questo contatore.

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

Valore della proprietà

Nome della categoria del contatore delle prestazioni (oggetto prestazioni) alla quale è associato questo contatore delle prestazioni.

Attributi

Eccezioni

L'elemento CategoryName è null.

Esempio

Nell'esempio di codice seguente viene creata un'istanza predefinita della PerformanceCounter classe . Dopo aver creato l'istanza, vengono impostati i valori delle CategoryNameproprietà , CounterNamee InstanceName e i risultati di una chiamata al NextValue metodo vengono visualizzati.

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

Commenti

Viene CategoryName visualizzato nel Performance Object campo dello snap MMC Gestione contatori prestazioni nella finestra di dialogo.Add Counter

Un contatore delle prestazioni monitora il comportamento di una categoria o di un oggetto prestazioni in un computer. Le categorie includono componenti fisici(ad esempio processori, dischi e memoria) e oggetti di sistema (ad esempio processi e thread). I contatori di sistema correlati allo stesso oggetto prestazioni vengono raggruppati in una categoria che indica lo stato attivo comune. Quando si crea un'istanza della PerformanceCounter classe , si indica innanzitutto la categoria con cui il componente interagirà e quindi si sceglie un contatore da tale categoria.

Ad esempio, una categoria di contatori di Windows è la categoria Memory. I contatori di sistema all'interno di questa categoria tengono traccia dei dati di memoria, ad esempio il numero di byte disponibili e il numero di byte memorizzati nella cache. Se si desidera utilizzare i byte memorizzati nella cache nell'applicazione, è necessario creare un'istanza del PerformanceCounter componente, connetterla alla categoria Memoria e quindi selezionare il contatore appropriato (in questo caso, Byte memorizzati nella cache) da tale categoria.

Anche se il sistema rende disponibili molte più categorie di contatori, le categorie con cui probabilmente interagirai più di frequente sono le categorie Cache, Memoria, Oggetti, PhysicalDisk, Process, Processor, Server, System e Thread.

Si applica a

Vedi anche