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

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 de objeto null (Nothing en Visual Basic).

O bien

El valor de counterName es referencia de objeto 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.

Sub Main(ByVal args() As String)
    Dim categoryName As String = ""
    Dim counterName As String = ""
    Dim machineName As String = ""
    Dim objectExists As Boolean = False

    ' Copy the supplied arguments into the local variables.
    Try
        categoryName = args(0)
        counterName = args(1)
        machineName = IIf(args(2) = ".", "", args(2))
    Catch ex As Exception
        ' Ignore the exception from non-supplied arguments.
    End Try

    Try
        ' Check whether the specified counter exists.
        ' Use the static forms of the CounterExists method.
        If machineName.Length = 0 Then
            objectExists = PerformanceCounterCategory.CounterExists( _
                counterName, categoryName)
        Else
            objectExists = PerformanceCounterCategory.CounterExists( _
                counterName, categoryName, machineName)
        End If

    Catch ex As Exception
        Console.WriteLine("Unable to check for the existence of " & _
            "counter ""{0}"" in category ""{1}"" on " & _
            IIf(machineName.Length > 0, _
            "computer ""{2}"".", "this computer.") & vbCrLf & _
            ex.Message, counterName, categoryName, machineName)
        Return
    End Try

    ' Tell the user whether the counter exists.
    Console.WriteLine("Counter ""{0}"" " & _
        IIf(objectExists, "exists", "does not exist") & _
        " in category ""{1}"" on " & _
        IIf(machineName.Length > 0, _
            "computer ""{2}"".", "this computer."), _
        counterName, categoryName, machineName)
End Sub

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition

.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.

.NET Framework

Compatible con: 2.0, 1.1, 1.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft