PerformanceCounterCategory.ReadCategory Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Odczytuje wszystkie dane licznika i wystąpienia obiektu wydajności skojarzone z tą kategorią licznika wydajności.
public:
System::Diagnostics::InstanceDataCollectionCollection ^ ReadCategory();public System.Diagnostics.InstanceDataCollectionCollection ReadCategory ();member this.ReadCategory : unit -> System.Diagnostics.InstanceDataCollectionCollectionPublic Function ReadCategory () As InstanceDataCollectionCollectionZwraca
Element InstanceDataCollectionCollection zawierający dane wystąpienia licznika i obiektu wydajności dla kategorii.
Wyjątki
Właściwość CategoryName to null. Właściwość mogła nie zostać ustawiona.
Wywołanie podstawowego interfejsu API systemu nie powiodło się.
Kod wykonywany bez uprawnień administracyjnych, który próbował odczytać licznik wydajności.
Przykłady
Poniższy przykład kodu tworzy obiekt PerformanceCounterCategory dla określonej PerformanceCounterCategory nazwy. Następnie używa ReadCategory metody , aby zwrócić obiekt InstanceDataCollectionCollection zawierający dane wystąpienia dla wszystkich wystąpień PerformanceCounter obiektów w obiekcie PerformanceCounterCategory.
// 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)
Uwagi
Przed wywołaniem ReadCategorymetody należy ustawić CategoryName właściwość .
Odczytywanie całej kategorii jednocześnie może być tak wydajne, jak odczytywanie pojedynczego licznika ze względu na sposób, w jaki system dostarcza dane.
Uwaga
Aby odczytać liczniki wydajności z sesji logowania nieinterakcyjnego w systemie Windows Vista i nowszych, Windows XP Professional x64 Edition lub Windows Server 2003, musisz być członkiem grupy użytkownicy monitor wydajności lub mieć uprawnienia administracyjne.
Aby uniknąć konieczności podniesienia uprawnień dostępu do liczników wydajności w systemie Windows Vista i nowszych, dodaj siebie do grupy użytkownicy monitor wydajności.
W systemie Windows Vista i nowszych Kontrola konta użytkownika (UAC) określa uprawnienia użytkownika. Jeśli jesteś członkiem wbudowanej grupy Administratorzy, masz przypisane dwa tokeny dostępu w czasie wykonywania: token dostępu użytkownika standardowego i token dostępu administratora. Domyślnie jesteś w roli użytkownika standardowego. Aby wykonać kod, który uzyskuje dostęp do liczników wydajności, należy najpierw podnieść poziom uprawnień od użytkownika standardowego do administratora. Możesz to zrobić po uruchomieniu aplikacji, klikając prawym przyciskiem myszy ikonę aplikacji i wskazując, że chcesz uruchomić jako administrator.
