Exportar (0) Imprimir
Expandir todo

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 static bool Exists (
	string categoryName
)
public static boolean Exists (
	String categoryName
)
public static function Exists (
	categoryName : String
) : boolean
No aplicable.

Parámetros

categoryName

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

Valor devuelto

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

Tipo de excepciónCondición

ArgumentNullException

El valor del parámetro categoryName es referencia null (Nothing en Visual Basic).

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.

NotaNota:

Para leer 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á la función 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. Esto se puede hacer cuando se inicia una aplicación haciendo clic con el botón secundario del mouse en el icono de la aplicación e indicando que se desea ejecutar como administrador.

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);

}

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

    CounterCreationData milkPerSecond = new CounterCreationData();
    milkPerSecond.set_CounterName("milk orders/second");
    milkPerSecond.set_CounterType(PerformanceCounterType.
        RateOfCountsPerSecond32);
    CounterCreationDataCollection ccds = 
        new CounterCreationDataCollection();
    ccds.Add(milkPerSecond);
    ccds.Add(milk);

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

Windows 98, Windows 2000 Service Pack 4, Windows Millennium, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0, 1.1, 1.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft