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

InstanceDataCollectionCollection.Contains (Método)

Determine si en la colección existe una colección de datos de instancia para el contador especificado (identificado por uno de los objetos InstanceDataCollection indizados).

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

public bool Contains (
	string counterName
)
public boolean Contains (
	String counterName
)
public function Contains (
	counterName : String
) : boolean

Parámetros

counterName

Nombre del contador de rendimiento.

Valor devuelto

true si en la colección existe una colección de datos de instancia que contiene el contador especificado; en caso contrario, false.

Tipo de excepciónCondición

ArgumentNullException

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

El parámetro counterName no distingue entre mayúsculas y minúsculas.

Cada objeto InstanceDataCollection de la colección contiene los datos de rendimiento para todos los contadores de una instancia. Los datos se indizan por nombre de contador y, a continuación, por nombre de instancia. Contains devuelve true si hay un objeto InstanceDataCollection cuyo contador asociado tiene el nombre especificado por el parámetro counterName.

En el código de ejemplo siguiente se acepta un nombre de categoría de la clase PerformanceCounter y un nombre de contador de la línea de comandos. Obtiene la colección InstanceDataCollectionCollection para el objeto PerformanceCounterCategory y, a continuación, utiliza el método Contains para determinar si existe el contador especificado. Si existe el contador, el ejemplo obtiene la colección InstanceDataCollection asociada y muestra los nombres de instancia de la colección.

Sub Main(ByVal args() As String)
    Dim categoryName As String = ""
    Dim counterName As String = ""

    Dim idColCol As InstanceDataCollectionCollection

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

    Try
        ' Get the InstanceDataCollectionCollection for this category.
        Dim pcc As New PerformanceCounterCategory(categoryName)
        idColCol = pcc.ReadCategory()
    Catch ex As Exception
        Console.WriteLine( _
            "An error occurred getting the InstanceDataCollection for " & _
            "category ""{0}""." & vbCrLf & ex.Message, categoryName)
        Return
    End Try

    ' Check if this counter name exists using the Contains
    ' method of the InstanceDataCollectionCollection.
    If Not idColCol.Contains(counterName) Then
        Console.WriteLine( _
            "Counter ""{0}"" does not exist in category ""{1}"".", _
            counterName, categoryName)
        Return
    Else
        ' Now get the counter's InstanceDataCollection object using the
        ' indexer (Item property) for the InstanceDataCollectionCollection.
        Dim countData As InstanceDataCollection = idColCol(counterName)

        Dim idColKeys As ICollection = countData.Keys
        Dim idColKeysArray(idColKeys.Count - 1) As String
        idColKeys.CopyTo(idColKeysArray, 0)

        Console.WriteLine("Counter ""{0}"" of category ""{1}"" " & _
            "has {2} instances.", counterName, categoryName, idColKeys.Count)

        ' Display the instance names for this counter.
        Dim index As Integer
        For index = 0 To idColKeysArray.Length - 1
            Console.WriteLine("{0,4} -- {1}", index + 1, idColKeysArray(index))
        Next index
    End If
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
Mostrar: