NextSample Método
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

PerformanceCounter.NextSample (Método) ()

 

Obtiene un contador de ejemplo y devuelve su valor sin formato o sin calcular.

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

member NextSample : unit -> CounterSample

Valor devuelto

Type: System.Diagnostics.CounterSample

Objeto CounterSample que representa el siguiente valor sin formato que el sistema obtiene para este contador.

Exception Condition
InvalidOperationException

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

-o-

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

Win32Exception

Se ha producido un error en el 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.

En general, este método se utiliza para contadores que contienen valores no calculados.

System_CAPS_noteNota

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.

System_CAPS_noteNota

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 sistema 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á el rol 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.Podrá hacerlo cuando inicie una aplicación haciendo clic con el botón secundario en el icono de la aplicación e indicando que desea ejecutarla como administrador.

El ejemplo de código siguiente muestra cómo utilizar el método NextSample para obtener el siguiente valor sin calcular de un contador.Este ejemplo de código forma parte de un ejemplo más extenso de la clase PerformanceCounter.

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

PerformanceCounterPermission

para leer la categoría de contador de rendimiento.Enumeración asociada: PerformanceCounterPermissionAccess.Read.

.NET Framework
Disponible desde 1.1
Volver al principio
Mostrar:
© 2016 Microsoft