Настройка Горячая перезагрузка (C#, VB, C++)

Вы можете отключить или включить Горячая перезагрузка (ранее называемый "Изменить и продолжить") в меню Visual Studio Tools>Options во время разработки. Горячая перезагрузка работает только в отладочных сборках. Дополнительные сведения см. в разделе Горячая перезагрузка.

Для нативного C++ Горячая перезагрузка требуется использовать параметр /INCREMENTAL. Дополнительные сведения о требованиях к функциям в C++ смотрите в этой записи блога и Редактирование и продолжение (C++).

Заметка

Если IntelliTrace включен, и вы собираете как события IntelliTrace, так и сведения о вызове, Горячая перезагрузка отключен. Дополнительные сведения см. в IntelliTrace.

Включение и настройка Горячая перезагрузка

Вы можете настроить Горячая перезагрузка, выбрав Settings в раскрывающемся списке Горячая перезагрузка.

Или откройте панель Tools>Options и настройте параметры в разделе Все настройки>Debugging>.NET/C++ Горячая перезагрузка. Имеются следующие варианты:

• Enable Горячая перезагрузка. Используйте функцию Горячая перезагрузка с кодом .NET и C++ при запуске приложения с подключенным отладчиком (F5).

• Автоматически применяют изменения при продолжении (только для нативного кода): Visual Studio автоматически компилирует и применяет все непримененные изменения кода, внесенные при продолжении отладочного процесса после остановки на точке останова. Если не выбрано, можно применить изменения с помощью элемента "Применить изменения кода " в меню отладки .

• Предупреждать об устаревшем коде (только для нативного кода): Предупреждения об устаревшем коде.

• Включить при отключенной отладке: Включает Горячая перезагрузка при запуске приложения без подключённого отладчика (Ctrl + F5).

• Применить при сохранении файла: применяет изменения при сохранении файла.

• Logging verbosity. Задайте уровень ведения журнала при включении Горячая перезагрузка: Минимальный, Подробный или Диагностический.

Для .NET Горячая перезагрузка вы также можете управлять доступностью Горячая перезагрузка на уровне проекта, изменив файл launchSettings.json в вашем проекте .NET 6+ и установив hotReloadEnabled на false.

Пример:

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

Настройка автоматического перезапуска

Горячая перезагрузка может автоматически перезапустить процесс приложения при отмене неподдерживаемого изменения (также называемого грубым изменением) вместо завершения всего сеанса отладки. Чтобы активировать это, измените файл проекта, добавив следующее объявление свойства.

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

Это свойство также можно задать в файле Directory.Build.props . Автоматическая перезагрузка работает для типов проектов, где быстрая перезагрузка процесса возможна (например, некоторые проекты Aspire или веб-проектов), чтобы продолжить отладку с минимальным прерыванием.

Это процессуальный перезапуск. Например, при отладке нескольких проектов только измененные проекты и все зависимые проекты будут перестроены и перезапущены.

Настройка Горячая перезагрузка для Razor

Размещая компилятор Razor внутри процесса Roslyn, редактирование файла .razor во время Горячая перезагрузка быстрее и эффективнее. Совместное размещение также повышает общую надежность при использовании Горячая перезагрузка.

Чтобы включить кохостинг, выберите Инструменты>Параметры, а затем выполните поиск cohost. Выберите или отмените выбор параметра Use Roslyn Cohost server for Razor (требуется перезапуск). Если этот параметр включен, перезапустите Visual Studio. Совместное размещение включено по умолчанию.

Сведения об устранении неполадок см. в разделе «Написание и отладка работающего кода с Горячая перезагрузка в Visual Studio».

Остановка изменений кода

Хотя Горячая перезагрузка находится в процессе применения изменений кода, можно остановить операцию.

Осторожность

Остановка изменений кода в управляемом коде может привести к непредвиденным результатам. Применение изменений к управляемому коду обычно является быстрым процессом, поэтому редко требуется остановить изменения кода в управляемом коде.

Чтобы остановить применение изменений кода, выполните следующее:

• Выберите Остановить применение изменений кода в меню отладки.

  Этот пункт меню отображается только при применении изменений кода.

  Если выбрать этот параметр, ни одно из изменений кода не фиксируется.