Cómo: Escribir valores en los contadores de rendimiento

Actualización: noviembre 2007

Escriba un valor en un contador incrementando el valor sin formato actual del contador en un número positivo o negativo. Para ello, utilice el método IncrementBy de la clase PerformanceCounter.

Nota:
Al incrementar en un número negativo, el contador disminuye en el valor absoluto del número. Por ejemplo, al aplicar un incremento con un valor de 3, el valor sin formato del contador aumenta en tres. Al aplicar un incremento con un valor de -3, el valor sin formato del contador disminuye en tres.

Asimismo, puede utilizar los métodos Increment y Decrement para aumentar o reducir los valores de un contador en uno. Estos métodos se procesan mucho más rápidamente que IncrementBy.

Sólo puede incrementar los valores de los contadores personalizados; de forma predeterminada, las interacciones con los contadores del sistema a través de una instancia del componente PerformanceCounter se limitan al modo de sólo lectura. Para poder incrementar un contador personalizado, primero debe establecer en false la propiedad ReadOnly de la instancia del componente con la que tiene acceso al mismo.

Nota:
Hay restricciones de seguridad que afectan a la posibilidad de utilizar contadores de rendimiento. Para obtener más información, vea Introducción a la supervisión de umbrales de rendimiento.

Nota:
La clase PerformanceCounter no es totalmente compatible con Microsoft Windows NT 4.0. Puede leer de los contadores del sistema, pero no puede crear, escribir ni eliminar contadores personalizados.

Para escribir valores en contadores de rendimiento

1. Cree una instancia de PerformanceCounter y configúrela de modo que interactúe con la categoría y el contador deseados. Para obtener más información, vea Cómo: Crear instancias de componentes PerformanceCounter o Cómo: Configurar instancias de componentes PerformanceCounter.

2. Escriba el valor utilizando uno de los métodos siguientes:

   Para	Llame a este método	Parámetro
   Aumentar en uno el valor sin formato	Increment	Ninguno
   Reducir en uno el valor sin formato	Decrement	Ninguno
   Aumentar en más de uno el valor sin formato	IncrementBy	Un entero positivo
   Reducir en más de uno el valor sin formato	IncrementBy	Un entero negativo
   Restablecer el valor sin formato en cualquier entero, en lugar de incrementarlo	RawValue	Un entero positivo o negativo

   En el código siguiente se muestra cómo establecer valores para un contador de diferentes maneras. Este ejemplo supone que estamos trabajando en una aplicación de Windows Forms que contiene un cuadro de texto txtValue y tres botones: el primero incrementa el valor sin formato en el número escrito en el cuadro, el segundo reduce el valor sin formato en uno y el tercero establece este valor del contador en el valor establecido en el cuadro de texto.

   Private Sub btnIncrement_Click(ByVal sender As System.Object, _
      ByVal e As System.EventArgs) Handles btnIncrement.Click
       PerformanceCounter1.ReadOnly = False
       PerformanceCounter1.IncrementBy(CLng(txtValue.Text))
   End Sub
   
   Private Sub btnDecrement_Click(ByVal sender As System.Object, _
      ByVal e As System.EventArgs) Handles btnDecrement.Click
       PerformanceCounter1.ReadOnly = False
       PerformanceCounter1.Decrement()
   End Sub
   
   Private Sub btnSetValue_Click(ByVal sender As System.Object, _
      ByVal e As System.EventArgs) Handles btnSetValue.Click
       PerformanceCounter1.ReadOnly = False
       PerformanceCounter1.RawValue = CLng(txtValue.Text)
   End Sub
   

    protected void btnIncrement_Click(object sender, EventArgs e)
       {
           performanceCounter1.ReadOnly = false;
           performanceCounter1.IncrementBy(long.Parse(txtValue.Text));
       }
   
       protected void btnDecrement_Click(object sender, EventArgs e)
       {
           performanceCounter1.ReadOnly = false;
           performanceCounter1.Decrement();
       }
   
       protected void btnSetValue_Click(object sender, EventArgs e)
       {
           performanceCounter1.ReadOnly = false;
           performanceCounter1.RawValue = long.Parse(txtValue.Text);
       }
   

Vea también

Conceptos

Introducción a la supervisión de umbrales de rendimiento

Recuperación del valor de los contadores de rendimiento