PerformanceCounterCategory.ReadCategory Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Liest sämtliche Daten für Indikator- und Leistungsobjektinstanzen, die dieser Leistungsindikatorkategorie zugeordnet sind.
public:
System::Diagnostics::InstanceDataCollectionCollection ^ ReadCategory();public System.Diagnostics.InstanceDataCollectionCollection ReadCategory ();member this.ReadCategory : unit -> System.Diagnostics.InstanceDataCollectionCollectionPublic Function ReadCategory () As InstanceDataCollectionCollectionGibt zurück
Eine InstanceDataCollectionCollection, die die Daten für Zähler- und Leistungsobjektinstanzen für die Kategorie enthält.
Ausnahmen
Die CategoryName-Eigenschaft ist null. Die Eigenschaft wurde möglicherweise nicht festgelegt.
Fehler beim Aufruf einer zugrunde liegenden System-API.
Ohne Administratorrechte ausgeführter Code hat versucht, einen Leistungsindikator zu lesen.
Beispiele
Im folgenden Codebeispiel wird ein PerformanceCounterCategory Name für einen angegebenen PerformanceCounterCategory Namen erstellt. Anschließend wird ein ReadCategory InstanceDataCollectionCollection Objekt zurückgegeben, das Instanzdaten für alle Instanzen der PerformanceCounter Objekte innerhalb des PerformanceCounterCategoryObjekts enthält.
// Process the InstanceDataCollectionCollection for this category.
PerformanceCounterCategory pcc = new PerformanceCounterCategory(categoryName);
InstanceDataCollectionCollection idColCol = pcc.ReadCategory();
InstanceDataCollection[] idColArray = new InstanceDataCollection[idColCol.Count];
Console.WriteLine("InstanceDataCollectionCollection for \"{0}\" " +
"has {1} elements.", categoryName, idColCol.Count);
' 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)
Hinweise
Sie müssen die CategoryName Eigenschaft festlegen, bevor Sie aufrufen ReadCategory.
Das Gleichzeitige Lesen der gesamten Kategorie kann so effizient sein, wie das Lesen eines einzelnen Zählers aufgrund der Art und Weise, wie das System die Daten bereitstellt.
Hinweis
Um Leistungsindikatoren aus einer nicht interaktiven Anmeldesitzung in Windows Vista und höher zu lesen, müssen Sie Windows XP Professional x64 Edition oder Windows Server 2003 Mitglied der Gruppe Leistungsmonitor Benutzer sein oder über Administratorrechte verfügen.
Um zu vermeiden, dass Sie Ihre Berechtigungen erhöhen müssen, um auf Leistungsindikatoren in Windows Vista und höher zuzugreifen, fügen Sie sich der Gruppe Leistungsmonitor Benutzer hinzu.
Unter Windows Vista (und höher) werden die Berechtigungen eines Benutzers von der Benutzerkontensteuerung (User Account Control, UAC) bestimmt. Als Mitglied der integrierten Administratorgruppe sind Ihnen zwei Zugriffstoken für die Laufzeit zugewiesen: ein Standardbenutzertoken und ein Administratorzugriffstoken. Standardmäßig verwenden Sie die Standardbenutzerrolle. Um den Code auszuführen, der auf Leistungsindikatoren zugreift, müssen Sie zuerst Ihre Berechtigungen vom Standardbenutzer zum Administrator erhöhen. Dazu starten Sie eine Anwendung, indem Sie mit der rechten Maustaste auf das Anwendungssymbol klicken und angeben, dass Sie die Anwendung als Administrator ausführen möchten.