Exportar (0) Imprimir
Expandir todo

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

Determina si el contador especificado está registrado en la categoría especificada de un equipo remoto.

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

public static bool CounterExists (
	string counterName,
	string categoryName,
	string machineName
)
public static boolean CounterExists (
	String counterName, 
	String categoryName, 
	String machineName
)
public static function CounterExists (
	counterName : String, 
	categoryName : String, 
	machineName : String
) : boolean
No aplicable.

Parámetros

counterName

Nombre del contador de rendimiento que se va a buscar.

categoryName

Nombre de la categoría de contador de rendimiento u objeto de rendimiento al que está asociado el contador de rendimiento especificado.

machineName

Nombre del equipo en el que residen la categoría del contador de rendimiento y los contadores asociados.

Valor devuelto

Es true si el contador está registrado en la categoría especificada del equipo especificado; de lo contrario, es false.

Tipo de excepciónCondición

ArgumentNullException

El valor de categoryName es referencia null (Nothing en Visual Basic).

O bien

El valor de counterName es referencia null (Nothing en Visual Basic).

ArgumentException

categoryName es una cadena vacía ("").

O bien

machineName no es válido.

Win32Exception

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

En el ejemplo de código siguiente se determina si existe un PerformanceCounter. Se obtiene un nombre de categoría, un nombre de contador y un nombre de equipo de la línea de comandos, si se han proporcionado. Se utilizan las sobrecargas estáticas del método CounterExists para determinar si existe el nombre de PerformanceCounter especificado en la PerformanceCounterCategory. La sobrecarga se selecciona basándose en si se ha proporcionado un nombre de equipo.

public static void Main(string[] args)
{
    string categoryName = "";
    string counterName = "";
    string machineName = "";
    bool objectExists = false;

    // Copy the supplied arguments into the local variables.
    try
    {
        categoryName = args[0];
        counterName = args[1];
        machineName = args[2]=="."? "": args[2];
    }
    catch(Exception ex)
    {
        // Ignore the exception from non-supplied arguments.
    }

    try
    {
        // Check whether the specified counter exists.
        // Use the static forms of the CounterExists method.
        if (machineName.Length==0)
        {
            objectExists = PerformanceCounterCategory.CounterExists(counterName, categoryName);
        }
        else
        {
            objectExists = PerformanceCounterCategory.CounterExists(counterName, categoryName, machineName);
        }

    }
    catch(Exception ex)
    {
        Console.WriteLine("Unable to check for the existence of " +
            "counter \"{0}\" in category \"{1}\" on " + 
            (machineName.Length>0? "computer \"{2}\".": "this computer.") + "\n" + 
            ex.Message, counterName, categoryName, machineName);
        return;
    }

    // Tell the user whether the counter exists.
    Console.WriteLine("Counter \"{0}\" "+ (objectExists? "exists": "does not exist") + 
        " in category \"{1}\" on " + (machineName.Length>0? "computer \"{2}\".": "this computer."), 
        counterName, categoryName, machineName);
}

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