PerformanceCounter.CategoryName Proprietà

Definizione

Ottiene o imposta il nome della categoria del contatore delle prestazioni di questo contatore.Gets or sets the name of the performance counter category for this performance counter.

public:
 property System::String ^ CategoryName { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.CategoryValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.CategoryValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.CategoryValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.ComponentModel.SettingsBindable(true)]
public string CategoryName { get; set; }
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.The name of the performance counter category (performance object) with which this performance counter is associated.

Attributi

Eccezioni

L'elemento CategoryName è null.The CategoryName is null.

Esempi

Nell'esempio di codice seguente viene creata un'istanza predefinita della classe PerformanceCounter.The following code example creates a default instance of the PerformanceCounter class. Una volta creata l'istanza, vengono impostati i valori delle proprietà CategoryName, CounterNamee InstanceName e vengono visualizzati i risultati di una chiamata al metodo NextValue.After the instance is created, the CategoryName, CounterName, and InstanceName property values are set, and the results of a call to the NextValue method are displayed.

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

Il CategoryName viene visualizzato nel campo Performance Object della finestra di dialogo Add Counter dello snap-in MMC di gestione del contatore delle prestazioni.The CategoryName is displayed in the Performance Object field of Performance Counter Manager MMC snap in's Add Counter dialog box.

Un contatore delle prestazioni monitora il comportamento di una categoria o di un oggetto prestazioni in un computer.A performance counter monitors the behavior of a category, or performance object, on a computer. Le categorie includono componenti fisici, ad esempio processori, dischi e memoria, e oggetti di sistema, ad esempio processi e thread.Categories include physical components (such as processors, disks, and memory) and system objects (such as processes and threads). I contatori di sistema correlati allo stesso oggetto prestazioni vengono raggruppati in una categoria che ne indica lo stato attivo comune.System counters that are related to the same performance object are grouped into a category that indicates their common focus. Quando si crea un'istanza della classe PerformanceCounter, viene innanzitutto indicata la categoria con cui il componente interagirà e quindi si sceglie un contatore da tale categoria.When you create an instance of the PerformanceCounter class, you first indicate the category with which the component will interact, and then you choose a counter from that category.

Una categoria di contatori di Windows, ad esempio, è la categoria di memoria.For example, one Windows counter category is the Memory category. 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.System counters within this category track memory data such as the number of bytes available and the number of bytes cached. Se si desidera utilizzare i byte memorizzati nella cache dell'applicazione, creare un'istanza del componente PerformanceCounter, connetterla alla categoria memoria, quindi selezionare il contatore appropriato (in questo caso, byte memorizzati nella cache) da tale categoria.If you wanted to work with the bytes cached in your application, you would create an instance of the PerformanceCounter component, connect it to the Memory category, and then pick the appropriate counter (in this case, Cached Bytes) from that category.

Sebbene il sistema renda disponibili molte più categorie di contatori, le categorie che probabilmente interagiranno con maggiore frequenza sono le categorie cache, memoria, oggetti, PhysicalDisk, processo, processore, server, sistema e thread.Although your system makes many more counter categories available, the categories that you will probably interact with most frequently are the Cache, Memory, Objects, PhysicalDisk, Process, Processor, Server, System, and Thread categories.

Si applica a

Vedi anche