PerformanceCounter.InstanceName Vlastnost

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Diagnostics.PerformanceCounter.dll

Balíček:

System.Diagnostics.PerformanceCounter v8.0.0

Zdroj:

PerformanceCounter.cs

Získá nebo nastaví název instance pro tento čítač výkonu.

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

Hodnota vlastnosti

String

Název instance kategorie čítače výkonu nebo prázdný řetězec (""), pokud je čítač čítačem s jednou instancí.

Příklady

Následující příklad kódu vytvoří výchozí instanci PerformanceCounter třídy . Po vytvoření CategoryNameinstance jsou nastaveny hodnoty vlastností , CounterNamea InstanceName a zobrazí se NextValue výsledky volání metody.

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())

Poznámky

Poznámka

Názvy instancí musí být kratší než 128 znaků.

V některých situacích jsou kategorie rozděleny na instance, které sledují data o více výskytech objektu, ke kterému se kategorie vztahuje. Instance se vztahují na kategorii jako celek, nikoli na jednotlivé čítače. Každý čítač v rámci kategorie má pro kategorii definovanou každou instanci. Například kategorie Proces obsahuje instance s názvy Nečinný a Systém. Každý čítač v kategorii Proces tedy obsahuje data pro každou instanci a zobrazuje informace o nečinných nebo systémových procesech.

Mnoho kategorií neobsahuje více instancí, takže tuto vlastnost můžete nechat prázdnou, aby bylo možné označit, že ke kategorii není přidružena žádná instance.

Pokud tato PerformanceCounter instance odkazuje na jinou než vlastní kategorii, můžete si vybrat pouze z existujících instancí kategorií. Nové instance kategorií můžete vytvářet pouze ve vlastních kategoriích, které umožňují definovat tolik čítačů a instancí kategorií, kolik potřebujete.

Chcete-li vytvořit instanci kategorie výkonu, zadejte v konstruktoru instanceNamePerformanceCounter . Pokud instance kategorie určená nástrojem instanceName již existuje, nový objekt bude odkazovat na existující instanci kategorie.

Poznámka

Nepoužívejte v názvu instance znaky "(", ")", "#", "\" nebo "/". Pokud se použije některý z těchto znaků, konzola výkonu (viz profilace modulu runtime) nemusí správně zobrazit hodnoty instance.

Pokud se název instance vygeneruje automaticky a může obsahovat znaky "(", ")", "#", "\" nebo "/", použijte mapování znaků v následující tabulce.

Znak	Mapovaný znak
(	[
)	]
#	_
\	_
/	_

Vlastnost FriendlyName objektu získaného AppDomain z AppDomain.CurrentDomain vlastnosti je běžným zdrojem názvů instancí, které mohou obsahovat neplatné znaky.