PerformanceCounter.InstanceName Vlastnost

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Diagnostics.PerformanceCounter.dll

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í instance jsou nastaveny CategoryNamehodnoty , CounterNamea InstanceName vlastnosti a výsledky volání NextValue metody jsou zobrazeny.

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í mít délku kratší než 128 znaků.

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

Mnoho kategorií neobsahuje více instancí, takže tuto vlastnost můžete ponechat prázdnou, abyste označili, že k kategorii není přidružena žádná instance.

Pokud tato PerformanceCounter instance odkazuje na kategorii, která nenícustom, 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 instanceName konstruktoru PerformanceCounter . Pokud instance kategorie zadaná instanceName již existuje, nový objekt bude odkazovat na existující instanci kategorie.

Poznámka:

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

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

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

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