Поделиться через


/debug (параметры компилятора C#)

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

/debug[+ | <U>-</U>]
/debug:{<U>full</U> | pdbonly}

Аргументы

  • + | -
    При задании + или только /debug компилятор создает отладочную информацию и помещает ее в базу данных программы (файл с расширением PDB). Если задан параметр -, который работает при отсутствии параметра /debug, отладочные данные не создаются.

  • full | pdbonly
    Указывает тип отладочной информации, создаваемой компилятором. Аргумент full, действующий при отсутствии параметра /debug:pdbonly, позволяет присоединить отладчик к выполняющейся программе. Задание параметра pdbonly позволяет выполнять отладку исходного кода при запуске программы в отладчике, но при этом ассемблер отображается только при подключении выполняющейся программы к отладчику.

Заметки

Используйте эту опцию для создания отладочных версий. Если не задать параметр /debug, /debug+ или /debug:full, то отладка выходного файла программы будет невозможна.

При использовании параметра /debug:full необходимо учитывать некоторое влияние на скорость и размер оптимизированного кода JIT и незначительное влияние на качество кода с /debug:full. Для создания кода выпуска рекомендуется использовать параметр /debug:pdbonly либо не использовать PDB.

Примечание

Отличие /debug:pdbonly от /debug:full заключается в том, что компилятор с параметром /debug:full создает DebuggableAttribute, сообщающий JIT-компилятору о доступности отладочных сведений.Поэтому, если при использовании параметра /debug:full код содержит DebuggableAttribute со значением "false", будет выведено сообщение об ошибке.

Дополнительные сведения о настройке производительности приложения см. в разделе Способы упрощения отладки изображений.

Сведения об изменении расположения файла с расширением PDB см. в разделе /pdb (параметры компилятора C#).

Установка параметра компилятора в среде разработки Visual Studio

  1. Откройте страницу Свойства проекта.

  2. Выберите страницу свойств Построение.

  3. Нажмите кнопку Дополнительно.

  4. Измените свойство Отладочная информация.

Дополнительные сведения об установке этого параметра компилятора программным путем см. в разделе DebugSymbols.

Пример

Разместите отладочную информацию в выходном файле app.pdb.

csc /debug /pdb:app.pdb test.cs

См. также

Другие ресурсы

Параметры компилятора C#

Свойства проекта (Visual Studio)