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

Propiedad InstanceDataCollectionCollection.Item (String)

 

Publicado: octubre de 2016

Obtiene los datos de instancia para el contador especificado.

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

Public ReadOnly Property Item (
	counterName As String
) As InstanceDataCollection

Parámetros

counterName
Type: System.String

El nombre del contador de rendimiento.

Valor de propiedad

Type: System.Diagnostics.InstanceDataCollection

Un InstanceDataCollection elemento por el cual el InstanceDataCollectionCollection se indiza el objeto.

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. El indizador usa el counterName parámetro para recorrer los contadores asociados a esta colección de datos de instancia.

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. A continuación, si la PerformanceCounter existe, el ejemplo utiliza el Item propiedad (hace referenciado como indizador) para obtener 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: