PerformanceCounter.CategoryName Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Diagnostics
Zestaw:
System.Diagnostics.PerformanceCounter.dll
Zestaw:
System.dll
Pakiet:
System.Diagnostics.PerformanceCounter v6.0.0
Pakiet:
System.Diagnostics.PerformanceCounter v7.0.0
Pakiet:
System.Diagnostics.PerformanceCounter v8.0.0
Pakiet:
System.Diagnostics.PerformanceCounter v9.0.0-preview.2.24128.5
Źródło:
PerformanceCounter.cs
Źródło:
PerformanceCounter.cs
Źródło:
PerformanceCounter.cs

Pobiera lub ustawia nazwę kategorii licznika wydajności dla tego licznika wydajności.

public:
 property System::String ^ CategoryName { System::String ^ get(); void set(System::String ^ value); };
public string CategoryName { get; set; }
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.CategoryValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string CategoryName { get; set; }
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.CategoryValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string CategoryName { get; set; }
[System.ComponentModel.SettingsBindable(true)]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.CategoryValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string CategoryName { get; set; }
member this.CategoryName : string with get, set
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.CategoryValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.CategoryName : string with get, set
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.CategoryValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.CategoryName : string with get, set
[<System.ComponentModel.SettingsBindable(true)>]
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.CategoryValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.CategoryName : string with get, set
Public Property CategoryName As String

Wartość właściwości

String

Nazwa kategorii licznika wydajności (obiektu wydajności), z którą jest skojarzony ten licznik wydajności.

Atrybuty
TypeConverterAttribute SettingsBindableAttribute

Wyjątki

ArgumentNullException

Wartość CategoryName to null.

Przykłady

Poniższy przykład kodu tworzy domyślne wystąpienie PerformanceCounter klasy . Po utworzeniu CategoryNamewystąpienia są ustawiane wartości właściwości , CounterNamei InstanceName , a wyniki wywołania NextValue metody są wyświetlane.

PerformanceCounter^ PC = gcnew PerformanceCounter;
PC->CategoryName = "Process";
PC->CounterName = "Private Bytes";
PC->InstanceName = "Explorer";
MessageBox::Show( PC->NextValue().ToString() );

PerformanceCounter performanceCounter = new PerformanceCounter();
performanceCounter.CategoryName = "Process";
performanceCounter.CounterName = "Private Bytes";
performanceCounter.InstanceName = "Explorer";
MessageBox.Show(performanceCounter.NextValue().ToString());

Dim PC As New PerformanceCounter()
PC.CategoryName = "Process"
PC.CounterName = "Private Bytes"
PC.InstanceName = "Explorer"
MessageBox.Show(PC.NextValue().ToString())

Uwagi

Element CategoryName jest wyświetlany w Performance Object polu przystawki MMC Menedżera licznika Add Counter wydajności w oknie dialogowym.

Licznik wydajności monitoruje zachowanie kategorii lub obiektu wydajności na komputerze. Kategorie obejmują składniki fizyczne (takie jak procesory, dyski i pamięć) oraz obiekty systemowe (takie jak procesy i wątki). Liczniki systemowe powiązane z tym samym obiektem wydajności są pogrupowane w kategorię, która wskazuje ich wspólny fokus. Podczas tworzenia wystąpienia PerformanceCounter klasy należy najpierw wskazać kategorię, z którą składnik będzie wchodzić w interakcje, a następnie wybierasz licznik z tej kategorii.

Na przykład jedną kategorią licznika systemu Windows jest kategoria Pamięć. Liczniki systemowe w tej kategorii śledzą dane pamięci, takie jak liczba dostępnych bajtów i liczba bajtów buforowanych. Jeśli chcesz pracować z bajtami buforowanym w aplikacji, utwórz wystąpienie PerformanceCounter składnika, połącz je z kategorią Pamięć, a następnie wybierz odpowiedni licznik (w tym przypadku buforowane bajty) z tej kategorii.

Mimo że system udostępnia wiele innych kategorii liczników, kategorie, z którymi prawdopodobnie będziesz korzystać, to kategorie pamięci podręcznej, pamięci, obiektów, dysk fizyczny, proces, procesor, serwer, system i wątki.

Dotyczy

Zobacz też