VSPerfCLREnv

Narzędzie VSPerfCLREnv służy do ustawiania zmiennych środowiskowych, które są wymagane do profilu aplikacji.NET Framework.Używa ono następującej składni:

VsPerfCLREnv [/option]

Opcja, którą wybierzesz, zależy od tego, którego z trzech typów profilowania używasz: próbkowanie, instrumentacja lub globalne.Oddzielna opcja jest wymagana, aby dołączyć dane o interakcji między warstwami do danych profilowania.Składnia każdej opcji została opisana w poniższych tabelach.

[!UWAGA]

Po zakończeniu profilowania, uruchom VSPerfCLREnv z opcją /off lub /globaloff, aby usunąć zmienne środowiskowe niezbędne do profilowania.Aby uzyskać więcej informacji, zobacz sekcję Opcje VSPerfCLREnv do usuwania ustawień środowiska, pokazaną niżej.

Opcje VSPerfCLREnv do dołączania danych o interakcji między warstwami

Przestroga
Profilowanie interakcji warstwy mogą być gromadzone przy użyciu Visual Studio Ultimate, Visual Studio Premium, lub Visual Studio Professional.Jednakże poziom interakcji profilowania danych można wyświetlać tylko w Visual Studio Ultimate i Visual Studio Premium.

Profilowanie interakcji między warstwami dostarcza dodatkowe informacje dotyczące zapytań ADO.NET w aplikacjach wielopoziomowych.Dane są zbierane jedynie dla synchronicznych wywołań funkcji.Dane o interakcji mogą zostać dodane do dowolnego uruchomienia profilowania, przy użyciu dowolnej metody profilowania.

Opcje InteractionOn i GlobalInteractionOn włączają zbieranie danych o interakcji między warstwami.Opcja interakcji musi zostać ustawiona po ustawieniu zmiennej środowiskowej VSPerfCLREnv, która jest wymagana do profilowania aplikacji.

Poniższy przykład zawiera dane o interakcji między warstwami w przebiegu profilowania, które używa metody próbkowania:

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

Poniższy przykład zawiera dane o interakcji między warstwami w przebiegu profilowania usługi systemu Windows:

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

Opcje VSPerfCLREnv do profilowania procesu metodą instrumentacji

W poniższej tabeli opisano opcje VSPerfCLREnv do profilowania metodą instrumentacji:

Opcja	Opis
TraceOn	Włącza profilowanie metodą instrumentacji.Nie włącza profilowania alokacji pamięci ani zbierania danych o okresie istnienia obiektu.
TraceGC	Włącza profilowanie alokacji pamięci metodą instrumentacji.Nie włącza zbierania danych o okresie istnienia obiektu.
TraceGCLife	Włącza profilowanie alokacji pamięci i zbieranie danych o okresie istnienia obiektu przy użyciu metody instrumentacji.

Opcje VSPerfCLREnv do profilowania procesu metodą próbkowania

W poniższej tabeli opisano opcje VSPerfCLREnv do profilowania metodą próbkowania:

Opcja	Opis
SampleOn	Włącza profilowanie metodą próbkowania.Nie włącza profilowania alokacji pamięci ani zbierania danych o okresie istnienia obiektu.
SampleGC	Włącza profilowanie alokacji pamięci metodą próbkowania.Nie włącza zbierania danych o okresie istnienia obiektu.
SampleGCLife	Włącza profilowanie alokacji pamięci metodą próbkowania.Włącza również zbieranie danych o okresie istnienia obiektu.
SampleLineOff	Wyłącza zbieranie danych profilowania na poziomie wiersza .NET.

Opcje VSPerfCLREnv do profilowania globalnego

Aby profilować usługę zarządzaną, taką jak aplikacja sieci Web ASP.NET, która została uruchomiona przez system operacyjny, a nie przez użytkownika, użyj opcji VSPerfCLREnv do profilowania globalnego.W poniższej tabeli opisano globalne wersje opcji VSPerfCLREnv.Opcje te ustawiają odpowiednie zmienne środowiskowe w rejestrze.

Opcja	Opis
GlobalTraceOn	Włącza profilowanie globalne metodą instrumentacji.Nie zbiera zdarzeń alokacji pamięci ani danych o okresie istnienia obiektu.
GlobalTraceGC	Włącza profilowanie globalne alokacji pamięci metodą instrumentacji.Nie włącza zbierania danych o okresie istnienia obiektu.
GlobalTraceGCLife	Włącza profilowanie globalne alokacji pamięci metodą instrumentacji.Włącza również zbieranie danych o okresie istnienia obiektu.
GlobalSampleOn	Włącza profilowanie globalne metodą próbkowania.Nie włącza zbierania zdarzeń alokacji pamięci ani danych o okresie istnienia obiektu.
GlobalSampleGC	Włącza profilowanie globalne alokacji pamięci metodą próbkowania.Nie włącza zbierania danych o okresie istnienia obiektu.
GlobalSampleGCLife	Włącza profilowanie globalne alokacji pamięci metodą próbkowania.Włącza również zbieranie danych o okresie istnienia obiektu.

Opcje VSPerfCLREnv do usuwania ustawień środowiska

Po zakończeniu profilowania aplikacji zarządzanych, użyj jednej z poniższych opcji, aby usunąć zmienne środowiskowe, które zostały dodane przez VSPerfCLREnv.W poniższej tabeli opisano, jak usunąć zarówno standardowe, jak i globalne zmienne środowiskowe:

Opcja	Opis
Off	Usuwa zmienne środowiskowe standardowego profilowania .NET.Użyj tej opcji, gdy do ustawienia zmiennych środowiskowych profilera nie były używane opcje globalne VSPerfClrEnv.
GlobalOff	Usuwa zmienne środowiskowe globalnego profilowania .NET.Użyj tej opcji, gdy aplikacja została uruchomiona przez system operacyjny, a nie przez profiler.

Uwagi

Opcje te nie są wymagane do profilowania aplikacji zarządzanych, jeśli aplikacja została uruchomiona przy użyciu Eksploratora wydajności w IDE.Eksplorator wydajności ustawia wszystkie wymagane ustawienia środowiskowe za użytkownika.

Jeśli podczas profilowania nie zostało ustawione poprawne środowisko, to podczas analizy zostanie raportowane ostrzeżenie, a nazwy funkcji zarządzanych nie zostaną poprawnie rozpoznane.

Zobacz też

Koncepcje

Korzystanie z narzędzi do profilowania z wiersza polecenia