Esta documentación está archivada y no tiene mantenimiento.

PerformanceCounterCategory.CounterExists (Método) (String)

Determina si el contador especificado está registrado en esta categoría; esta información se indica mediante las propiedades CategoryName y MachineName.

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

public bool CounterExists (
	string counterName
)
public boolean CounterExists (
	String counterName
)
public function CounterExists (
	counterName : String
) : boolean
No aplicable.

Parámetros

counterName

Nombre del contador de rendimiento que se va a buscar.

Valor devuelto

Es true si el contador está registrado en la categoría especificada por las propiedades CategoryName y MachineName; de lo contrario, es false.

Tipo de excepciónCondición

ArgumentNullException

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

InvalidOperationException

No se ha establecido el valor de la propiedad CategoryName.

Win32Exception

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

Debe establecer la propiedad CategoryName antes de llamar a este método. De lo contrario, se producirá una excepción.

Si no se ha establecido la propiedad MachineName, este método utiliza el equipo local (".").

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 crea un objeto PerformanceCounterCategory mediante la sobrecarga PerformanceCounterCategoryadecuada. A continuación, se utiliza el método CounterExists(String) para determinar si existe el PerformanceCounter especificado y se informa al usuario.

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

    // 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
    {
        if (machineName.Length==0)
        {
            pcc = new PerformanceCounterCategory(categoryName);
        }
        else
        {
            pcc = new PerformanceCounterCategory(categoryName, machineName);
        }

        // Check whether the specified counter exists.
        // Use the per-instance overload of CounterExists.
        objectExists = pcc.CounterExists(counterName);

    }
    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, pcc.CategoryName, pcc.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
Mostrar: