Параметры проекта для конфигураций отладки C# (.NET Core, .NET 5 и выше и ASP.NET Core)

  • Статья

Вы можете изменить параметры отладки для проекта C# на вкладках Отладка и Сборка страниц свойств проекта.

Чтобы открыть страницы свойств, выберите проект в Обозревателе решений и щелкните значок Свойства или щелкните этот проект правой кнопкой мыши и выберите Свойства.

Дополнительные сведения см. в разделе Конфигурации отладки и выпуска.

Важно!

Эти параметры не применяются к .NET Framework и приложениям UWP. Настройка параметров отладки для .NET Framework описана в статье Параметры проекта для конфигураций отладки C#.

Вкладки отладчика

В Visual Studio 2022 и последующих версиях вы можете открыть пользовательский интерфейс отладки профилей запуска для изменения параметров на вкладке "Отладка".

Профиль запуска (.NET Core, .NET 5 и выше)

Параметр Description
Аргументы командной строки. Определяет аргументы командной строки для отлаживаемого приложения. Имя команды — это имя приложения, которое указано в поле Запуск внешней программы.
Рабочий каталог Определяет рабочий каталог для отлаживаемого приложения. В C# по умолчанию рабочим считается каталог \bin\debug.
Использовать удаленный компьютер Для удаленной отладки выберите этот вариант и введите имя удаленного целевого объекта отладки или имя сервера Msvsmon.
Расположение приложения на удаленном компьютере указывается свойством Output Path на вкладке "Сборка ". Расположение должно быть общим каталогом на удаленном компьютере.
Переменные среды Задает переменные среды перед запуском процесса приложения. Для ASP.NET Core см. статью Среды.
Разрешить отладку неуправляемого кода Выполняет отладку вызовов машинного (неуправляемого) кода Win32 из управляемого приложения.
Разрешить отладку SQL Server Выполняет отладку объектов базы данных SQL Server.
Включить отладку WebView2 Отладка JavaScript в отладчике на базе Microsoft Edge (Chromium).

Профиль запуска (ASP.NET Core)

Помимо свойств для .NET 5 и выше, профили запуска включают несколько дополнительных свойств для различных профилей ASP.NET Core. Следующие параметры доступны в простом пользовательском интерфейсе для файла launchSettings.json проекта. Дополнительные сведения об этом файле см. в разделе "Разработка и launchSettings.json" из статьи Использование нескольких сред в ASP.NET Core.

Пользовательский интерфейс профилей запуска включают следующие параметры.

Параметр Description
Запуск браузера Позволяет выбрать, нужно ли при запуске отладки запускать браузер по умолчанию, используя параметр URL-адреса.
URL-адрес Задает URL-адрес расположения узла для .NET или .NET Core. Если профиль назван как проект (то есть свойство commandName в launchSettings.json имеет значение Project), то сервер Kestrel ожидает передачи данных по указанному порту. Для профиля IIS значение обычно совпадает с URL-адресом приложения. Дополнительные сведения см. в разделе Настройка проекта в части "Профиль запуска служб IIS".
URL-адрес приложения Задает URL-адреса приложения. Если профиль назван по проекту, это свойство задает URL-адреса сервера Kestrel (обычно https://localhost:5001 и http://localhost:5000).

Visual Studio предоставляет профиль IIS Express по умолчанию, и вы можете создавать дополнительные, например профиль IIS. Эти параметры также соответствуют параметрам в launchSettings.json. Эти два типа профилей предоставляют ряд параметров, например "Модель размещения".

Параметр Description
Модель размещения Позволяет выбрать "В процессе" (по умолчанию) или "Вне процесса". См. дополнительные сведения о моделях размещения в документации ASP.NET Core.
URL-адрес SSL приложения Для IIS Express URL-адрес SSL приложения — обычно http://localhost:44334..

Вкладка "Сборка"

В следующей таблице перечислены полезные для отладки параметры сборки. Полное описание параметров сборки см. на странице сборки в конструкторе проектов.

Параметр Description
Общие>Символы условной компиляции Здесь определяются константы DEBUG и TRACE, если они выбраны.

Эти константы включают условную компиляцию класса Debug и класса Trace. Если эти константы определены, методы классов Debug и Trace выполняют вывод в окно вывода. Если эти константы не определены, то методы классов Debug и Trace не компилируются и выходные данные не создаются.

Обычно константа DEBUG задается в отладочной версии программы и не имеет значения в версии выпуска. Константа TRACE обычно определяется и в отладочной версии, и в версии выпуска.
Общие>Оптимизировать код Если ошибка проявляется только в оптимизированном коде, не используйте этот параметр для отладочных сборок. Оптимизированный код отлаживать гораздо труднее, так как его команды не соответствуют в точности операторам в исходном коде.
Отладочные символы Определяет тип отладочной информации, создаваемой компилятором. См. раздел Отладочные символы. Сведения о настройке производительности отладки для приложения см. в разделе Упрощение отладки образов.
Вывод>Базовый путь вывода Задает базовую папку для промежуточного вывода. Выходные данные для отладочной сборки обычно передаются в bin\Debug.
Вывод>Базовый путь промежуточного вывода Задает базовую папку для промежуточного вывода. Выходные данные для отладочной сборки обычно передаются в obj\Debug.

Отладочные символы

Для отладочных символов можно выбрать следующие параметры.

  • Символы не порождаются

    Указывает, что отладочная информация создаваться не будет.

  • PDB-файл, текущая платформа

    Создает символьный PDB-файл под конкретную платформу, который предоставляет другим инструментам, особенно отладчикам, сведения о том, что содержится в основном исполняемом файле и как он был создан.

  • PDB-файл, переносимый

    Создает не зависящий от платформы PDB-файл, который предоставляет другим инструментам, особенно отладчикам, сведения о том, что содержится в основном исполняемом файле и как он был создан. Дополнительные сведения см. в статье Portable PDB.

  • Внедрение в DLL/EXE, переносимое между платформами

    Внедряет сведения переносимого файла символов в сборку. Внешний PDB-файл не создается.

Дополнительные сведения см. в разделе /debug (параметры компилятора C#).

См. также