InstanceDataCollection.Item-Eigenschaft

Ruft die Instanzdaten ab, die diesem Zähler zugeordnet sind. Dies ist i. d. R. eine Gruppe von unformatierten Zählerwerten.

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

Syntax

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

value = instance(instanceName)

public InstanceData this [
    string instanceName
] { get; }

public:
property InstanceData^ default [String^] {
    InstanceData^ get (String^ instanceName);
}

/** @property */
public InstanceData get_Item (String instanceName)

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

Parameter

• instanceName
  Der Name der Instanz der Leistungsindikatorkategorie oder eine leere Zeichenfolge (""), wenn die Kategorie eine einzelne Instanz enthält.

Eigenschaftenwert

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

Ausnahmen

Hinweise

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

Beispiel

Im folgenden Codebeispiel werden in der Befehlszeile ein PerformanceCounter-Kategoriename, -Zählername sowie -Instanzname akzeptiert. Die InstanceDataCollectionCollection wird für die Kategorie abgerufen, die eine Auflistung von InstanceDataCollection-Objekten ist. Daraus wird die bestimmte InstanceDataCollection für den angegebenen Zähler abgerufen. Dann wird, sofern die Instanz vorhanden ist, im Beispiel die Item-Eigenschaft (als Indexer referenziert) verwendet, um das zugehörige InstanceData-Objekt abzurufen.

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

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

InstanceDataCollection-Klasse
InstanceDataCollection-Member
System.Diagnostics-Namespace