Konfigurowanie edycji i kontynuowania (C#, VB, C++)

Możesz wyłączyć lub włączyć funkcję Hot Reload, wcześniej o nazwie Edytuj i Kontynuuj, z menu Narzędzia > Opcje programu Visual Studio w czasie projektowania. przeładowywanie na gorąco działa tylko w kompilacjach debugowania. Aby uzyskać więcej informacji, zobacz Hot Reload.

W przypadku natywnego języka C++ przeładowywanie na gorąco wymaga użycia opcji /INCREMENTAL. Aby uzyskać więcej informacji na temat wymagań funkcji w języku C++, zobacz ten wpis w blogu i Edytuj i Kontynuuj (C++).

Notatka

Jeśli funkcja IntelliTrace jest włączona i zbierasz zarówno zdarzenia IntelliTrace, jak oraz informacje o wywołaniach, funkcja przeładowania na gorąco jest wyłączona. Aby uzyskać więcej informacji, zobacz IntelliTrace.

Włączanie i konfigurowanie przeładowywania na gorąco

Możesz skonfigurować przeładowanie na gorąco, wybierając pozycję Ustawienia z listy rozwijanej Przeładowanie na gorąco.

Możesz też otworzyć okienko Narzędzia>Opcje i dostosować opcje w sekcji Wszystkie ustawienia>Debugowanie>.NET/C++ Przeładowywanie na gorąco. Dostępne są następujące opcje:

• Włącz Hot Reload: Użyj funkcji Hot Reload z kodem .NET i C++, gdy aplikacja jest uruchomiona z dołączonym debugerem (F5).

• Automatyczne stosowanie zmian w trybie kontynuacji (tylko natywna): program Visual Studio automatycznie kompiluje i stosuje wszelkie zaległe zmiany kodu wprowadzone podczas kontynuowania procesu ze stanu przerwania. Jeśli nie wybrano, możesz zastosować zmiany przy użyciu elementu Zastosuj zmiany kodu w menu Debugowanie .

• Ostrzegaj o nieaktualnym kodzie (tylko natywne): uzyskaj ostrzeżenia dotyczące nieaktualnego kodu.

• Włącz, gdy nie jest debugowane: włącza funkcję Przeładowywania na gorąco, gdy aplikacja działa bez dołączonego debugera (Ctrl + F5).

• Zastosuj przy zapisywaniu pliku: stosuje zmiany przy zapisie pliku.

• Szczegółowość rejestrowania: Ustaw poziom logowania po włączeniu funkcji Hot Reload: Minimalny, Szczegółowy lub Diagnostyczny.

W przypadku funkcji przeładowywania na gorąco w platformie .NET można również kontrolować dostępność tej funkcji na poziomie projektu, modyfikując plik launchSetting.json projektu .NET 6+ i ustawiając hotReloadEnabled na false.

Przykład:

{
  "profiles": {
    "Console": {
      "commandName": "Project",
      "hotReloadEnabled": false
    }
  }
}

Konfigurowanie automatycznego ponownego uruchamiania

Przeładowywanie na gorąco może automatycznie ponownie uruchomić proces aplikacji, gdy zostanie wykonana nieobsługiwana zmiana (nazywana również niegrzeczna edycja), zamiast kończenia całej sesji debugowania. Aby to włączyć, zmodyfikuj plik projektu, aby dodać następującą deklarację właściwości.

<PropertyGroup>
  <HotReloadAutoRestart>true</HotReloadAutoRestart>
</PropertyGroup>

Tę właściwość można również ustawić w pliku Directory.Build.props . Automatyczne ponowne uruchamianie działa w przypadku typów projektów, w których możliwe jest szybkie ponowne uruchomienie procesu (na przykład niektóre projekty aspirujące lub internetowe), dzięki czemu można kontynuować debugowanie z minimalnymi przerwami.

Jest to ponowne uruchomienie oparte na procesie. Jeśli na przykład debugujesz kilka projektów, tylko zmienione projekty i wszystkie projekty zależne, zostaną ponownie skompilowane i uruchomione ponownie.

Konfigurowanie Hot Reload dla Razor

Dzięki współhostowaniu kompilatora Razor wewnątrz procesu Roslyn edytowanie pliku razor podczas ponownego ładowania na gorąco jest szybsze i bardziej wydajne. Współhostowanie zwiększa również ogólną niezawodność podczas używania funkcji Hot Reload.

Aby włączyć współhostowanie, wybierz pozycję Narzędzia>Opcje, a następnie wyszukaj ciąg cohost. Wybierz lub usuń zaznaczenie ustawienia Użyj serwera Cohost Roslyn dla Razor (wymaga ponownego uruchomienia). Jeśli włączysz tę opcję, uruchom ponownie program Visual Studio. Współhostowanie jest domyślnie włączone.

Zatrzymaj zmiany kodu

Podczas gdy przeładowywanie na gorąco jest w trakcie stosowania zmian kodu, możesz zatrzymać operację.

Ostrożność

Zatrzymywanie zmian kodu w kodzie zarządzanym może spowodować nieoczekiwane wyniki. Stosowanie zmian w kodzie zarządzanym jest zwykle szybkim procesem, dlatego rzadko trzeba zatrzymać zmiany kodu w kodzie zarządzanym.

Aby przestać stosować zmiany kodu:

• Wybierz Zatrzymaj stosowanie zmian kodu z menu Debug.

  Ten element menu jest widoczny tylko wtedy, gdy są stosowane zmiany kodu.

  Jeśli wybierzesz tę opcję, żaden ze zmian kodu nie zostanie zatwierdzony.