PerformanceCounter.InstanceName Właściwość

Definicja

Przestrzeń nazw:

System.Diagnostics

Zestaw:

System.Diagnostics.PerformanceCounter.dll

Pakiet:

System.Diagnostics.PerformanceCounter v8.0.0

Źródło:

PerformanceCounter.cs

Pobiera lub ustawia nazwę wystąpienia dla tego licznika wydajności.

public:
 property System::String ^ InstanceName { System::String ^ get(); void set(System::String ^ value); };

public string InstanceName { get; set; }

member this.InstanceName : string with get, set

Public Property InstanceName As String

Wartość właściwości

String

Nazwa wystąpienia kategorii licznika wydajności lub pusty ciąg (""), jeśli licznik jest licznikiem pojedynczego wystąpienia.

Przykłady

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

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

Uwaga

Nazwy wystąpień muszą być krótsze niż 128 znaków.

W niektórych sytuacjach kategorie są podzielone na wystąpienia, które śledzą dane o wielu wystąpieniach obiektu powiązanego z kategorią. Wystąpienia mają zastosowanie do kategorii jako całości, a nie do poszczególnych liczników. Każdy licznik w kategorii ma każde wystąpienie zdefiniowane dla kategorii. Na przykład kategoria Proces zawiera wystąpienia o nazwie Idle i System. Każdy licznik w kategorii Przetwarzanie zawiera zatem dane dla każdego wystąpienia, pokazując informacje o bezczynnych procesach lub procesach systemowych.

Wiele kategorii nie zawiera wielu wystąpień, dlatego możesz pozostawić tę właściwość pustą, aby wskazać, że żadne wystąpienie nie jest skojarzone z kategorią.

Jeśli to PerformanceCounter wystąpienie wskazuje kategorię inną niżcustom, możesz wybrać tylko istniejące wystąpienia kategorii. Możesz tworzyć nowe wystąpienia kategorii tylko w kategoriach niestandardowych, które umożliwiają definiowanie jak największej liczby liczników i wystąpień kategorii zgodnie z potrzebami.

Aby utworzyć wystąpienie kategorii wydajności, określ element instanceName na konstruktorze PerformanceCounter . Jeśli wystąpienie kategorii określone przez instanceName już istnieje, nowy obiekt będzie odwoływać się do istniejącego wystąpienia kategorii.

Uwaga

Nie używaj znaków "(", ")", "#", "\" lub "/" w nazwie wystąpienia. Jeśli którykolwiek z tych znaków jest używany, konsola wydajności (zobacz Profilowanie środowiska uruchomieniowego) może nie wyświetlać poprawnie wartości wystąpienia.

Jeśli nazwa wystąpienia jest generowana automatycznie i może zawierać znaki "(", ")", "#", "\" lub "/", użyj mapowania znaków w poniższej tabeli.

Znak	Zamapowany znak
(	[
)	]
#	_
\	_
/	_

Właściwość FriendlyNameAppDomain obiektu uzyskanego z AppDomain.CurrentDomain właściwości jest typowym źródłem nazw wystąpień, które mogą zawierać nieprawidłowe znaki.