InstanceDataCollectionCollection.Item-Eigenschaft

Ruft die Instanzdaten für den angegebenen Zähler ab.

Namespace: System.Diagnostics
Assembly: System (in system.dll)

Syntax

'Declaration
Public ReadOnly Default Property Item ( _
    counterName As String _
) As InstanceDataCollection
'Usage
Dim instance As InstanceDataCollectionCollection
Dim counterName As String
Dim value As InstanceDataCollection

value = instance(counterName)

public InstanceDataCollection this [
    string counterName
] { get; }

public:
property InstanceDataCollection^ default [String^] {
    InstanceDataCollection^ get (String^ counterName);
}

/** @property */
public InstanceDataCollection get_Item (String counterName)

JScript unterstützt die Verwendung von indizierten Eigenschaften, aber nicht die Deklaration von neuen indizierten Eigenschaften.

Parameter

• counterName
  Der Name des Leistungsindikators.

Eigenschaftenwert

Ein InstanceDataCollection-Element, mit dem das InstanceDataCollectionCollection-Objekt indiziert wird.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentNullException	Der counterName-Parameter ist NULL (Nothing in Visual Basic).

Hinweise

Beim counterName-Parameter wird die Groß- und Kleinschreibung nicht berücksichtigt.

Jedes InstanceDataCollection-Objekt in der Auflistung enthält die Leistungsdaten für sämtliche Zähler einer Instanz. Die Daten werden erst nach Zählernamen und anschließend nach Instanznamen indiziert. Der Indexer verwendet den counterName-Parameter zum schrittweisen Durchlaufen der Zähler, die dieser Auflistung von Instanzdaten zugeordnet sind.

Beispiel

Im folgenden Codebeispiel werden ein PerformanceCounter-Kategoriename und -Zählername über die Befehlszeile angenommen. Ruft InstanceDataCollectionCollection für PerformanceCounterCategory ab. Wenn PerformanceCounter vorhanden ist, wird im Beispiel anschließend die Item-Eigenschaft, auf die als Indexerstellung verwiesen wird, zum Abrufen der zugeordneten InstanceDataCollection verwendet, und die Instanznamen aus der Auflistung werden angezeigt.

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

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

InstanceDataCollectionCollection-Klasse
InstanceDataCollectionCollection-Member
System.Diagnostics-Namespace