Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método PerformanceCounter.NextValue ()

 

Publicado: octubre de 2016

Obtiene una muestra de contador y devuelve el valor calculado para él.

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

member NextValue : unit -> float32

Valor devuelto

Type: System.Single

El siguiente valor calculado que el sistema obtiene para este contador.

Exception Condition
InvalidOperationException

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

Win32Exception

Error de acceso a la API del sistema.

PlatformNotSupportedException

La plataforma es Windows 98 o Windows Millennium Edition, que no admite los contadores de rendimiento.

UnauthorizedAccessException

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

System_CAPS_noteNota

Si el valor calculado de un contador depende de dos lecturas de contador, la primera operación de lectura devuelve 0,0. Restablecer las propiedades de contador de rendimiento para especificar otro contador es equivalente a crear un nuevo contador de rendimiento y la primera operación de lectura con las nuevas propiedades devuelve 0,0. El tiempo de retardo recomendado entre llamadas a la NextValue método es un segundo, para permitir que el contador que se va a realizar la lectura incremental siguiente.

System_CAPS_noteNota

Para leer los contadores de rendimiento, debe tener privilegios administrativos. 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á el rol de usuario estándar. Para ejecutar el código que tiene acceso a los contadores de rendimiento, primero debe elevar sus privilegios de usuario estándar a administrador. Para ello, inicie una aplicación haciendo clic con el botón derecho en el icono de la aplicación e indique que desea ejecutarla como administrador.

En el ejemplo de código siguiente se crea un ElapsedTime contador y se utiliza el NextValue método para mostrar los valores del contador durante un período de tiempo.

No hay ningún ejemplo de código disponible o este idioma no es compatible.

PerformanceCounterPermission

for reading the performance counter category. Associated enumeration: F:System.Diagnostics.PerformanceCounterPermissionAccess.Read.

.NET Framework
Disponible desde 1.1
Volver al principio
Mostrar: