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 InstanceDataCollection.Item (String)

 

Publicado: octubre de 2016

Obtiene los datos de instancia asociados a este contador. Por lo general, suele ser un conjunto de valores de contador sin formato.

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

Public ReadOnly Property Item (
	instanceName As String
) As InstanceData

Parámetros

instanceName
Type: System.String

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

Valor de propiedad

Type: System.Diagnostics.InstanceData

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

Exception Condition
ArgumentNullException

El parámetro instanceName es null.

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

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

Sub Main(ByVal args() As String)
    ' These values can be used as arguments.
    Dim categoryName As String = "Process"
    Dim counterName As String = "Private Bytes"
    Dim instanceName As String = "Explorer"

    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

.NET Framework
Disponible desde 1.1
Volver al principio
Mostrar: