Exportar (0) Imprimir
Expandir todo
Este tema aún no ha recibido ninguna valoración - Valorar este tema

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

Determina si una categoría especificada en el equipo local contiene la instancia de objeto de rendimiento especificada.

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

public static bool InstanceExists (
	string instanceName,
	string categoryName
)
public static boolean InstanceExists (
	String instanceName, 
	String categoryName
)
public static function InstanceExists (
	instanceName : String, 
	categoryName : String
) : boolean

Parámetros

instanceName

Instancia de objeto de rendimiento que se va a buscar.

categoryName

Categoría de contador de rendimiento en la que se va a buscar.

Valor devuelto

Es true si la categoría contiene la instancia de objeto de rendimiento especificada; de lo contrario, es false.
Tipo de excepciónCondición

ArgumentNullException

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

O bien

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 ("").

Win32Exception

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

No es posible determinar si una instancia de objeto de rendimiento reside en un equipo sin especificar la categoría específica en la que se debe buscar.

En el ejemplo de código siguiente se utilizan las sobrecargas estáticas de InstanceExists para determinar si existe la instancia de PerformanceCounter especificada en la PerformanceCounterCategory. La sobrecarga se selecciona basándose en si se ha especificado un nombre de equipo. Si no hay ningún nombre de instancia especificado, se utiliza en el ejemplo el nombre predeterminado de la instancia única.

Sub Main(ByVal args() As String)
    Dim categoryName As String = ""
    Dim instanceName As String = ""
    Dim machineName As String = ""
    Dim objectExists As Boolean = False
    Const SINGLE_INSTANCE_NAME As String = _
        "systemdiagnosticsperfcounterlibsingleinstance"

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

    ' Use the given instance name or use the default single-instance name.
    If instanceName.Length = 0 Then
        instanceName = SINGLE_INSTANCE_NAME
    End If

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

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

    ' Tell the user whether the instance exists.
    Console.WriteLine("Instance ""{0}"" " & _
        IIf(objectExists, "exists", "does not exist") & _
        " in category ""{1}"" on " & _
        IIf(machineName.Length > 0, _
            "computer ""{2}"".", "this computer."), _
        instanceName, 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.