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

String

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 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 PC=new PerformanceCounter();
PC.CategoryName="Process";
PC.CounterName="Private Bytes";
PC.InstanceName="Explorer";
MessageBox.Show(PC.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 snapC MMC di Performance Counter Manager nella finestra di Add Counter dialogo.

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 PerformanceCounter della classe, si indica innanzitutto la categoria con cui il componente interagisce e quindi si sceglie un contatore da tale categoria.

Ad esempio, una categoria di contatore di Windows è la categoria Memoria. 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 usare i byte memorizzati nella cache nell'applicazione, si creerebbe 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 si interagisce più frequentemente sono le categorie Cache, Memory, Memory, Objects, PhysicalDisk, Process, Processor, Server, System e Thread.

Si applica a

Vedi anche