Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

PerformanceCounterCategory.Exists (Método) (String, String)

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

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

public static bool Exists(
	string categoryName,
	string machineName
)

Parámetros

categoryName
Tipo: System.String
Nombre de la categoría de contador de rendimiento que se va a buscar.
machineName
Tipo: System.String
Nombre del equipo en el que se va a buscar la categoría.

Valor devuelto

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

ExcepciónCondición
ArgumentNullException

El valor del parámetro categoryName es null.

ArgumentException

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

O bien

El parámetro machineName no es válido.

Win32Exception

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

IOException

No se puede encontrar la ruta de acceso a la red.

UnauthorizedAccessException

El llamador no dispone del permiso requerido.

O bien

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.

NotaNota

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 Orders. Si no existe, el ejemplo crea el objeto PerformanceCounterCategory utilizando un objeto CounterCreationDataCollection que contiene dos contadores de rendimiento.


if (!PerformanceCounterCategory.Exists("Orders"))
{
    CounterCreationData milk = new CounterCreationData();
    milk.CounterName = "milk";
    milk.CounterType = PerformanceCounterType.NumberOfItems32;

    CounterCreationData milkPerSecond = new CounterCreationData();
    milkPerSecond.CounterName = "milk orders/second";
    milkPerSecond.CounterType = PerformanceCounterType.RateOfCountsPerSecond32;

    CounterCreationDataCollection ccds = new CounterCreationDataCollection();
    ccds.Add(milkPerSecond);
    ccds.Add(milk);

    PerformanceCounterCategory.Create("Orders", "Number of processed orders",
        PerformanceCounterCategoryType.SingleInstance, ccds);

}


.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft