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

InstanceDataCollection.Item (Propiedad)

Obtiene los datos de instancia asociados a este contador. Normalmente, es un conjunto de valores de contador sin formato.

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

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

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

Parámetros

instanceName

Nombre de la instancia de categoría del contador de rendimiento, o cadena vacía (""), si la categoría contiene una sola instancia.

Valor de propiedad

Elemento InstanceData por el que se indiza el objeto InstanceDataCollection.

Tipo de excepciónCondición

ArgumentNullException

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

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

El ejemplo de código siguiente acepta un nombre de categoría de PerformanceCounter, un nombre de contador y un nombre de instancia desde la línea de comandos. Obtiene el objeto InstanceDataCollectionCollection para la categoría, que consiste en una colección de objetos InstanceDataCollection. De esa colección obtiene el objeto InstanceDataCollection particular para el contador especificado. A continuación, si la instancia existe, el ejemplo utiliza la propiedad Item (a la que se hace referencia como indizador) para obtener el objeto InstanceData asociado.

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

    Dim idCol As InstanceDataCollection
    Const SINGLE_INSTANCE_NAME As String = _
        "systemdiagnosticsperfcounterlibsingleinstance"

    ' Copy the supplied arguments into the local variables.
    Try
        categoryName = args(0)
        counterName = args(1)
        instanceName = args(2)
    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)
        Dim idColCol As InstanceDataCollectionCollection = _
            pcc.ReadCategory()

        ' Get the InstanceDataCollection for this counter.
        idCol = idColCol(counterName)
        If idCol Is Nothing Then
            Throw New Exception("Counter does not exist.")
        End If
    Catch ex As Exception
        Console.WriteLine( _
            "An error occurred getting the InstanceDataCollection for " & _
            "category ""{0}"", counter ""{1}""." & vbCrLf & ex.Message, _
            categoryName, counterName)
        Return
    End Try

    ' If the instance name is empty, use the single-instance name.
    If instanceName.Length = 0 Then
        instanceName = SINGLE_INSTANCE_NAME
    End If

    ' Check if this instance name exists using the Contains
    ' method of the InstanceDataCollection.
    If Not idCol.Contains(instanceName) Then
        Console.WriteLine( _
            "Instance ""{0}"" does not exist in counter ""{1}"", " & _
            "category ""{2}"".", instanceName, counterName, categoryName)
        Return
    Else
        ' The instance name exists, now get its InstanceData object
        ' using the indexer (Item property) for the InstanceDataCollection.
        Dim instData As InstanceData = idCol(instanceName)

        Console.WriteLine("CategoryName: {0}", categoryName)
        Console.WriteLine("CounterName:  {0}", counterName)
        Console.WriteLine("InstanceName: {0}", instData.InstanceName)
        Console.WriteLine("RawValue:     {0}", instData.RawValue)
    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: