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

InstanceDataCollectionCollection.Item (Propiedad)

Obtiene los datos de instancia para el contador especificado.

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

public InstanceDataCollection this [
	string counterName
] { get; }
/** @property */
public InstanceDataCollection get_Item (String counterName)

JScript admite el uso de propiedades indizadas, pero no admite la declaración de propiedades nuevas.

Parámetros

counterName

Nombre del contador de rendimiento.

Valor de propiedad

Elemento de InstanceDataCollection por el que se indiza el objeto InstanceDataCollectionCollection.

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

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