PerformanceCounterCategory.ReadCategory-Methode

Liest sämtliche Daten für Indikator- und Leistungsobjektinstanzen, die dieser Leistungsindikatorkategorie zugeordnet sind.

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

Syntax

'Declaration
Public Function ReadCategory As InstanceDataCollectionCollection
'Usage
Dim instance As PerformanceCounterCategory
Dim returnValue As InstanceDataCollectionCollection

returnValue = instance.ReadCategory

public InstanceDataCollectionCollection ReadCategory ()

public:
InstanceDataCollectionCollection^ ReadCategory ()

public InstanceDataCollectionCollection ReadCategory ()

public function ReadCategory () : InstanceDataCollectionCollection

Rückgabewert

Eine InstanceDataCollectionCollection, die die Daten für Zähler- und Leistungsobjektinstanzen für die Kategorie enthält.

Ausnahmen

Hinweise

Sie müssen vor dem Aufrufen von ReadCategory die CategoryName-Eigenschaft festlegen.

Aufgrund der Art der Datenbereitstellung durch das System bietet das Lesen eines einzelnen Indikators u. U. keinen Vorteil gegenüber dem Lesen der gesamten Kategorie in einem Vorgang.

Beispiel

Im folgenden Codebeispiel wird eine PerformanceCounterCategory für einen angegebenen PerformanceCounterCategory-Namen erstellt. Dann wird ReadCategory verwendet, um eine InstanceDataCollectionCollection zurückzugeben, die Instanzdaten für alle Instanzen der PerformanceCounter-Objekte in der PerformanceCounterCategory enthält.

' Process the InstanceDataCollectionCollection for this category.
Dim pcc As New PerformanceCounterCategory(categoryName)
Dim idColCol As InstanceDataCollectionCollection = pcc.ReadCategory()
Dim idColArray(idColCol.Count - 1) As InstanceDataCollection

Console.WriteLine("InstanceDataCollectionCollection for ""{0}"" " & _
    "has {1} elements.", categoryName, idColCol.Count)

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

PerformanceCounterCategory-Klasse
PerformanceCounterCategory-Member
System.Diagnostics-Namespace
InstanceDataCollectionCollection-Klasse
InstanceDataCollection-Klasse
InstanceData-Klasse