Esta documentación está archivada y no tiene mantenimiento.

PerformanceCounter.RawValue (Propiedad)

Actualización: noviembre 2007

Obtiene o establece el valor sin formato o sin calcular de este contador.

Espacio de nombres:  System.Diagnostics
Ensamblado:  System (en System.dll)

[BrowsableAttribute(false)]
public long RawValue { get; set; }
/** @property */
/** @attribute BrowsableAttribute(false) */
public long get_RawValue()
/** @property */
/** @attribute BrowsableAttribute(false) */
public  void set_RawValue(long value)

public function get RawValue () : long
public function set RawValue (value : long)

Valor de propiedad

Tipo: System.Int64
Valor sin formato del contador.

ExcepciónCondición
InvalidOperationException

Está intentando establecer el valor sin formato del contador, pero el contador es de sólo lectura.

O bien

La instancia no está correctamente asociada a un contador de rendimiento.

O bien,

La propiedad InstanceLifetime se ha establecido en Process pero se está utilizando la memoria compartida global.

Win32Exception

Error al obtener acceso a una API del sistema.

PlatformNotSupportedException

La plataforma es Windows 98 o Windows Millennium Edition (Me), que no admiten contadores de rendimiento.

UnauthorizedAccessException

Código que se ejecuta sin privilegios administrativos para intentar leer un contador de rendimiento.

Si el tipo de contador es de un tamaño de 32 bits y se intenta establecer esta propiedad en un valor demasiado grande, la propiedad trunca el valor a 32 bits. Cuando se leen contadores personalizados en el equipo local, si se utiliza la propiedad RawValue en lugar de un valor calculado, puede obtenerse un rendimiento significativamente mayor en escenarios en los que el valor sin formato sea suficiente.

Si el contador que se está leyendo es de sólo lectura, el hecho de obtener la propiedad RawValue hace que el contador se muestree en el momento en que se llama a dicha propiedad. Esta acción es equivalente a realizar una llamada inicial al método NextSample. Si posteriormente llama a NextSample, puede realizar cálculos con los valores devueltos por ambas llamadas.

Dado que los contadores del sistema son de sólo lectura, puede obtener sus valores sin formato, pero no puede establecerlos.

8y4xc84y.alert_note(es-es,VS.90).gifNota:

Los métodos Increment, IncrementBy y Decrement utilizan interbloqueos para actualizar el valor de contador. Esto ayuda a mantener la precisión del valor de contador en los escenarios multiproceso, pero también produce una reducción del rendimiento. Si no necesita la precisión que proporcionan las operaciones interbloqueadas, puede actualizar la propiedad RawValue directamente y conseguir que el rendimiento mejore hasta 5 veces. Sin embargo, en los escenarios multiproceso, quizás se omitan algunas actualizaciones del valor de contador, produciendo datos inexactos.

8y4xc84y.alert_note(es-es,VS.90).gifNota:

Si el valor para la propiedad InstanceLifetime es Process y la categoría de contador de rendimiento se ha creado con la versión 1.0 o 1.1 de .NET Framework, se produce una excepción InvalidOperationException. Las categorías de contador de rendimiento que se crean con las versiones anteriores utilizan la memoria compartida global y el valor de InstanceLifetime debe ser Global. Si las aplicaciones que se ejecutan con las versiones 1.0 o 1.1 de .NET Framework no utilizan la categoría, elimínela y vuelva a crearla.

8y4xc84y.alert_note(es-es,VS.90).gifNota:

Para leer los contadores de rendimiento de Windows Vista, Windows XP Professional x64 Edition o Windows Server 2003, debe ser miembro del grupo Usuarios del Monitor de rendimiento o tener privilegios administrativos.

Para evitar la elevación de los privilegios de acceso a los contadores de rendimiento en Windows Vista, agregue su propio usuario al grupo Usuarios del monitor de sistema.

En Windows Vista, el Control de cuentas de usuario (UAC) determina los privilegios de un usuario. Si es miembro del grupo Administradores integrados, se le asignarán dos símbolos (tokens) de acceso en tiempo de ejecución: un símbolo (token) de acceso de usuario estándar y un símbolo (token) de acceso de administrador. De forma predeterminada, se le asignará la función de usuario estándar. Para ejecutar el código que tiene acceso a los contadores de rendimiento, primero debe elevar el nivel de sus privilegios de usuario estándar a administrador. Puede hacerlo si inicia una aplicación haciendo clic con el botón secundario en el icono de la aplicación e indicando que desea ejecutarla como administrador.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0, 1.1, 1.0
Mostrar: