PerformanceCounter.CategoryName Propiedad

Definición

Espacio de nombres:

System.Diagnostics

Ensamblado:

System.Diagnostics.PerformanceCounter.dll

Paquete:

System.Diagnostics.PerformanceCounter v8.0.0

Source:

PerformanceCounter.cs

Obtiene o establece el nombre de la categoría de contador de rendimiento para este contador de rendimiento.

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

Valor de propiedad

String

Nombre de la categoría de contador de rendimiento (objeto de rendimiento) a la que está asociado este contador de rendimiento.

Excepciones

ArgumentNullException

El valor de CategoryName es null.

Ejemplos

En el ejemplo de código siguiente se crea una instancia predeterminada de la PerformanceCounter clase . Una vez creada la instancia, se establecen los CategoryNamevalores de propiedad , CounterNamey InstanceName , y se muestran los resultados de una llamada al NextValue método .

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

Comentarios

CategoryName se muestra en el Performance Object campo del complemento MMC del Administrador de contadores de rendimiento en el cuadro de Add Counter diálogo.

Un contador de rendimiento supervisa el comportamiento de una categoría o un objeto de rendimiento en un equipo. Las categorías incluyen componentes físicos (como procesadores, discos y memoria) y objetos del sistema (como procesos y subprocesos). Los contadores del sistema relacionados con el mismo objeto de rendimiento se agrupan en una categoría que indica su enfoque común. Cuando cree una instancia de la PerformanceCounter clase, primero indique la categoría con la que interactuará el componente y, a continuación, elija un contador de esa categoría.

Por ejemplo, una categoría de contador de Windows es la categoría Memoria. Los contadores del sistema de esta categoría realizan un seguimiento de los datos de memoria, como el número de bytes disponibles y el número de bytes almacenados en caché. Si quisiera trabajar con los bytes almacenados en caché en la aplicación, crearía una instancia del PerformanceCounter componente, la conectaría a la categoría Memoria y, a continuación, elegiría el contador adecuado (en este caso, Bytes almacenados en caché) de esa categoría.

Aunque el sistema hace que haya muchas más categorías de contadores disponibles, las categorías con las que probablemente interactúe con más frecuencia son las categorías Caché, Memoria, Objetos, FísicoDisk, Proceso, Procesador, Servidor, Sistema y Subproceso.

Consulte también

• ProcessName