PerformanceCounter.InstanceName Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Diagnostics

Zestaw:: System.Diagnostics.PerformanceCounter.dll

Zestaw:: System.dll

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.

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; }

[System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string InstanceName { get; set; }

[System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string InstanceName { get; set; }

[System.ComponentModel.SettingsBindable(true)]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string InstanceName { get; set; }

[System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string InstanceName { get; set; }

member this.InstanceName : string with get, set

[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.InstanceName : string with get, set

[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.InstanceName : string with get, set

[<System.ComponentModel.SettingsBindable(true)>]
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.InstanceName : string with get, set

[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
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.

Atrybuty: TypeConverterAttribute SettingsBindableAttribute

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 PC=new PerformanceCounter();
PC.CategoryName="Process";
PC.CounterName="Private Bytes";
PC.InstanceName="Explorer";
MessageBox.Show(PC.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ń, więc można 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ść FriendlyName obiektu uzyskanego AppDomain z AppDomain.CurrentDomain właściwości jest typowym źródłem nazw wystąpień, które mogą zawierać nieprawidłowe znaki.

Dotyczy