VSPerfCLREnv

Nástroj VSPerfCLREnv slouží k nastavení proměnné prostředí, které jsou nutné k profilu aplikace rozhraní.NET Framework.Používá následující syntaxi:

VsPerfCLREnv [/option]

Zvolená možnost závisí na tom, který z těchto tří typů profilování bude použit: vzorkování, instrumentace a globální.Chcete-li do dat profilování zahrnout data interakcí mezi vrstvami, je vyžadována samostatná možnost.Syntaxe každé z možností je popsána v následujících tabulkách.

[!POZNÁMKA]

Poté, co je profilování dokončeno, odstraňte proměnné prostředí potřebné pro profilování spuštěním programu VSPerfCLREnv s možností /off nebo /globaloff.Další informace naleznete v oddílu "Možnosti nástroje VSPerfCLREnv pro odstranění nastavení prostředí" tohoto dokumentu.

Možnosti nástroje VSPerfCLREnv pro zahrnutí dat interakce mezi vrstvami

Upozornění
Profilování interakce vrstvy mohou být shromažďovány pomocí Visual Studio Ultimate, Visual Studio Premium, nebo Visual Studio Professional.Je však interakce vrstvy profilování dat lze zobrazit pouze v Visual Studio Ultimate a Visual Studio Premium.

Profilování interakcí mezi vrstvami poskytuje dodatečné informace o dotazech ADO.NET ve vícevrstvých aplikacích.Data jsou shromážděna pouze pro synchronní volání funkcí.Data interakcí mohou být přidána do libovolného profilování používajícího libovolnou metodu.

Možnosti InteractionOn a GlobalInteractionOn umožňují shromažďování dat interakcí mezi vrstvami.Možnosti interakce musí být nastaveny až po nastavení proměnné prostředí nástroje VSPerfCLREnv potřebné k profilování aplikace.

V následujícím příkladu jsou zahrnuta data interakcí mezi vrstvami do profilování metodou vzorkování:

VSPerfCLREnv /SampleOn
VSPerfCLREnv /InteractionOn
VSPerfCmd /Start:Sample /Output:MyApp.exe.vsp /Launch:MyApp.exe

V následujícím příkladu jsou zahrnuta data interakcí mezi vrstvami do profilování služby systému Windows:

VSPerfCLREnv /GlobalSampleOn
VSPerfCLREnv /GlobalInteractionOn
REM Restart the computer and start the service
VSPerfCmd /Start:Sample /Output:MyService.exe.vsp 
VSPerfCmd /Attach:MyService.exe

Možnost nástroje VSPerfCLREnv pro profilování procesů metodou instrumentace

Následují tabulka popisuje možnosti nástroje VSPerfCLREnv pro profilování metodou instrumentace:

Možnost	Description
TraceOn	Povolí profilování metodou instrumentace.Nepovolí profilování přidělování paměti nebo sběr dat o životnosti objektu.
TraceGC	Povolí profilování přidělování paměti pomocí metody instrumentace.Nepovolí sběr dat o životnosti objektu.
TraceGCLife	Povolí profilování přidělování paměti a sběr dat o životnosti objektu pomocí metody instrumentace.

Možnost nástroje VSPerfCLREnv pro profilování procesů metodou vzorkování

Následují tabulka popisuje možnosti nástroje VSPerfCLREnv pro profilování metodou vzorkování:

Možnost	Description
SampleOn	Povolí profilování metodou vzorkování.Nepovolí profilování přidělování paměti nebo sběr dat o životnosti objektu.
SampleGC	Povolí profilování přidělování paměti pomocí metody vzorkování.Nepovolí sběr dat o životnosti objektu.
SampleGCLife	Povolí profilování přidělování paměti pomocí metody vzorkování.Také povolí sběr dat o životnosti objektu.
SampleLineOff	Zakáže sběr dat profilování na úrovní řádků .NET.

Možnosti nástroje VSPerfCLREnv pro globální profilování

Chcete-li profilovat spravovanou službu, například webovou aplikaci ASP.NET, spuštěnou operačním systémem namísto uživatelem, použijte možnosti nástroje VSPerfCLREnv pro globální profilování.Následují tabulka popisuje globální verze možností nástroje VSPerfCLREnv.Tyto možností nastavují příslušné proměnné prostředí v registru.

Možnost	Description
GlobalTraceOn	Povolí globální profilování metodou instrumentace.Nesbírá data o přidělování paměti ani o životnosti objektu.
GlobalTraceGC	Povolí globální profilování přidělování paměti pomocí metody instrumentace.Nepovolí sběr dat o životnosti objektu.
GlobalTraceGCLife	Povolí globální profilování přidělování paměti pomocí metody instrumentace.Také povolí sběr dat o životnosti objektu.
GlobalSampleOn	Povolí globální profilování metodou vzorkování.Nepovolí sběr událostí přidělování paměti ani dat o životnosti objektu.
GlobalSampleGC	Povolí globální profilování přidělování paměti pomocí metody vzorkování.Nepovolí sběr dat o životnosti objektu.
GlobalSampleGCLife	Povolí globální profilování přidělování paměti pomocí metody vzorkování.Také povolí sběr dat o životnosti objektu.

Možnosti nástroje VSPerfCLREnv pro odstranění nastavení prostředí

Po dokončení profilování spravované aplikace odstraňte proměnné prostředí přidané nástrojem VSPerfCLREnv pomocí jedné z následujících možností.Následující tabulka popisuje, jak odstranit standardní i globální proměnné prostředí:

Možnost	Description
Off	Odstraní proměnné prostředí pro standardní profilování .NET.Tuto možnost použijte, pokud pro nastavení proměnných prostředí profileru byly použity možnosti nástroje VSPerfCLREnv, které nejsou globální.
GlobalOff	Odstraní proměnné prostředí pro globální profilování .NET.Tuto možnost použijte, pokud byla aplikace spuštěna operačním systémem, nikoli profilerem.

Poznámky

Je-li aplikace spuštěna pomocí Průzkumníku výkonu v prostředí IDE, nejsou tyto možnosti pro profilování spravované aplikace vyžadovány.Průzkumník výkonu provede všechna potřebná nastavení prostředí.

Pokud nebylo během profilování nastaveno správné prostředí, je během analýzy zobrazeno upozornění a nejsou správně vyhodnoceny názvy spravovaných funkcí.

Viz také

Koncepty

Pomocí Profilování nástroje z příkazového řádku