Compartir a través de


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