Exists Método (String)
Collapse the table of content
Expand the table of content
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

PerformanceCounterCategory.Exists (Método) (String)

 

Determina si la categoría está registrada en el equipo local.

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

Public Shared Function Exists (
	categoryName As String
) As Boolean

Parámetros

categoryName

Nombre de la categoría de contador de rendimiento que se va a buscar.

Valor devuelto

Type: System.Boolean

Es true si la categoría está registrada; de lo contrario, es false.

Exception Condition
ArgumentNullException

El valor del parámetro categoryName es null.

ArgumentException

El parámetro categoryName es una cadena vacía ("").

Win32Exception

Se ha producido un error en la llamada a una API del sistema subyacente.

UnauthorizedAccessException

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

El uso del método Exists puede producir una reducción del rendimiento notable mientras se comprueba la disponibilidad de todos los contadores de rendimiento.Sí sólo está escribiendo a un contador de rendimiento, puede evitar la búsqueda global de contadores de rendimiento creando el contador de rendimiento cuando se instala la aplicación y considerando que la categoría existe cuando se obtiene acceso al contador.No hay ninguna manera de evitar la búsqueda del contador de rendimiento cuando se leen los contadores de rendimiento.

System_CAPS_noteNota

Para leer los contadores de rendimiento de Windows Vista y versiones posteriores, 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 y versiones posteriores, agregue su propio usuario al grupo Usuarios del monitor de sistema.

En Windows Vista y posteriores, 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.

En el ejemplo de código siguiente se determina si existe un objeto PerformanceCounterCategory denominado "pedidos".Si no, crea el objeto PerformanceCounterCategory utilizando un objeto CounterCreationDataCollection que contiene dos contadores de rendimiento.

If Not PerformanceCounterCategory.Exists("Orders") Then        
    Dim milk As New CounterCreationData()
    milk.CounterName = "milk"
    milk.CounterType = PerformanceCounterType.NumberOfItems32

    Dim milkPerSecond As New CounterCreationData()
    milkPerSecond.CounterName = "milk orders/second"
    milkPerSecond.CounterType = PerformanceCounterType.RateOfCountsPerSecond32

    Dim ccds As New CounterCreationDataCollection()
    ccds.Add(milkPerSecond)
    ccds.Add(milk)

    PerformanceCounterCategory.Create("Orders", "Number of processed orders", _
           PerformanceCounterCategoryType.SingleInstance, ccds)
End If

PerformanceCounterPermission

para leer las categorías de contador de rendimiento.Enumeración asociada: PerformanceCounterPermissionAccess.Read.

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