Exportar (0) Imprimir
Expandir todo
Personas que lo han encontrado útil: 0 de 10 - Valorar este tema

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
)
public static boolean Exists (
	String categoryName, 
	String machineName
)
public static function Exists (
	categoryName : String, 
	machineName : String
) : boolean

Parámetros

categoryName

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

machineName

Nombre del equipo en el que se va a buscar la categoría.

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

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.

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.

En el ejemplo de código siguiente se utiliza una sobrecarga del método Exists para determinar si existe la PerformanceCounterCategory especificada en el equipo local o en un equipo especificado. 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 machineName As String = ""
    Dim objectExists As Boolean = False

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

    ' Check if the specified category exists.
    Try
        If machineName.Length = 0 Then
            objectExists = PerformanceCounterCategory.Exists(categoryName)
        Else
            objectExists = PerformanceCounterCategory.Exists( _
                categoryName, machineName)
        End If

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

    ' Tell the user whether the category exists.
    Console.WriteLine("Category ""{0}"" " & _
        IIf(objectExists, "exists", "does not exist") & _
        " on " & IIf(machineName.Length > 0, _
        "computer ""{1}"".", "this computer."), _
        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
¿Te ha resultado útil?
(Caracteres restantes: 1500)
Gracias por sus comentarios

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft. Reservados todos los derechos.