Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método InstanceDataCollectionCollection.Contains (String)

 

Publicado: octubre de 2016

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

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

Public Function Contains (
	counterName As String
) As Boolean

Parámetros

counterName
Type: System.String

El nombre del contador de rendimiento.

Valor devuelto

Type: System.Boolean

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

Exception Condition
ArgumentNullException

El parámetro counterName es null.

El counterName parámetro distingue mayúsculas de minúsculas.

Cada InstanceDataCollection objeto 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 InstanceDataCollection cuyo contador asociado tiene el nombre del objeto especificado por el counterName parámetro.

En el ejemplo de código siguiente se acepta un PerformanceCounter nombre de categoría y el nombre de contador de la línea de comandos. Obtiene el InstanceDataCollectionCollection para el PerformanceCounterCategory y, a continuación, usa el Contains method para determinar si existe el contador especificado. Si el contador no existe, el ejemplo obtiene asociado InstanceDataCollection 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

.NET Framework
Disponible desde 1.1
Volver al principio
Mostrar: