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.NextSample ()

 

Publicado: octubre de 2016

Obtiene una muestra de contador y devuelve el valor sin formato o sin calcular para él.

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

Public Function NextSample As CounterSample

Valor devuelto

Type: System.Diagnostics.CounterSample

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

Exception Condition
InvalidOperationException

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

-o-

El InstanceLifetime propiedad está establecida en Process cuando uso global memoria compartida.

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.

Este método se utiliza normalmente para los contadores que contienen valores no calculados.

System_CAPS_noteNota

Si el valor de la InstanceLifetime propiedad es Process y la categoría de contador de rendimiento se ha creado con .NET Framework versión 1.0 o 1.1, un InvalidOperationException se produce. Categorías de contador de rendimiento creados con versiones anteriores utilizan la memoria compartida global y el valor de InstanceLifetime debe ser Global. Si no se utiliza la categoría por aplicaciones que se ejecutan en las versiones 1.0 y 1.1 de .NET Framework, elimine y vuelva a la categoría.

System_CAPS_noteNota

Para leer los contadores de rendimiento en 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 tener que elevar sus privilegios para tener acceso a los contadores de rendimiento en Windows Vista, agréguese al grupo usuarios del Monitor de rendimiento.

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 muestra cómo utilizar el NextSample método 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 PerformanceCounter clase.

Private Shared Sub CollectSamples(ByVal samplesList As ArrayList)

    Dim r As New Random(DateTime.Now.Millisecond)

    ' Loop for the samples.
    Dim j As Integer
    For j = 0 To 99

        Dim value As Integer = r.Next(1, 10)
        Console.Write(j.ToString() + " = " + value.ToString())

        avgCounter64Sample.IncrementBy(value)

        avgCounter64SampleBase.Increment()

        If j Mod 10 = 9 Then
            OutputSample(avgCounter64Sample.NextSample())
            samplesList.Add(avgCounter64Sample.NextSample())
        Else
            Console.WriteLine()
        End If
        System.Threading.Thread.Sleep(50)
    Next j
End Sub 'CollectSamples

PerformanceCounterPermission

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

.NET Framework
Disponible desde 1.1
Volver al principio
Mostrar: