Отладка приложений ASP.NET и ASP.NET Core в Visual Studio

Вы можете выполнять отладку приложений ASP.NET и ASP.NET Core в Visual Studio. Точный процесс зависит от типа приложения (ASP.NET или ASP.NET Core) и от того, выполняется ли он в IIS Express или на локальном сервере IIS.

Предварительные требования для локального сервера IIS

Можно также выполнять отладку приложения ASP.NET или ASP.NET Core на локальном сервере IIS (версии 8.0 или более поздней), настроенном для запуска этого приложения. Для отладки на локальном сервере IIS необходимо выполнить следующие требования.

• Если она не установлена, установите рабочую нагрузку ASP.NET и веб-разработка. (Перезапустите Visual Studio Installer, выберите Изменить и добавьте эту рабочую нагрузку.)

• Запустите Visual Studio от имени администратора.

• Установить и правильно настроить IIS, указав соответствующие версии ASP.NET и (или) ASP.NET Core. Дополнительные сведения об использовании IIS с ASP.NET Core см. в статье Размещение ASP.NET Core в Windows со службами IIS. Инструкции для ASP.NET см. в статье Установка служб IIS и модулей ASP.NET.

• Убедиться, что приложение работает в IIS без ошибок.

Отладка приложений ASP.NET

Сервер IIS Express используется по умолчанию и уже предварительно настроен. Если вы хотите выполнять отладку на локальном сервере IIS, убедитесь, что выполняются требования для отладки на локальном сервере IIS.

1. Выберите проект ASP.NET в Обозревателе решений Visual Studio, щелкните значок Свойства и нажмите сочетание клавиш ALT+ВВОД либо щелкните проект правой кнопкой мыши и выберите пункт Свойства.

2. Перейдите на вкладку Интернет.

   Если вы не видите веб-вкладку, см. статью "Отладка ASP.NET Основных приложений". Веб-вкладка отображается только для ASP платформа .NET Framework.

3. В области Свойства в разделе Серверы выполните следующее.

   • Для Kestrel выберите https из раскрывающегося списка.
   • Для сервера IIS Express выберите IIS Express в раскрывающемся списке.
   • Для локальных служб IIS
     1. в раскрывающемся списке выберите Локальный сервер IIS;
     2. рядом с полем URL-адрес проекта установите флажок Создать виртуальный каталог, если вы еще не настроили приложение в службах IIS.

4. В разделе Отладчики выберите ASP.NET.

   

5. Выберите Файл>Сохранить выбранные элементы или нажмите сочетание клавиш CTRL+S, чтобы сохранить изменения.

6. Для отладки приложения установите точки останова в некоторых местах кода проекта. На панели инструментов Visual Studio убедитесь, что для конфигурации задано значение Отладка, и нужный вам браузер отображается в поле эмулятора IIS Express (<имя браузера>) или Локальный сервер IIS (<имя браузера>) в поле эмулятора.

7. Чтобы начать отладку, на панели инструментов выберите IIS Express (<имя браузера>) или Локальный сервер IIS (<имя браузера>), а затем выберите Начать отладку в меню Отладка или нажмите клавишу F5. Отладчик приостанавливает выполнение в точках останова. Если отладчик не может попасть в точки останова, см. раздел Устранение неполадок при отладке.

Устранение неполадок отладки

Если при отладке на локальном сервере IIS не удается достичь точки останова, выполните следующие шаги для устранения неполадок.

1. Запустите веб-приложение из IIS и убедитесь, что оно работает правильно. Оставьте веб-приложение работать.

2. В Visual Studio выберите Отладка > Подключение к процессу или нажмите клавиши CTRL+ALT+P, а затем подключитесь к процессу ASP.NET или ASP.NET Core (обычноw3wp.exe или dotnet.exe). Дополнительные сведения см. в разделах Подключение к процессу и Поиск имени процесса ASP.NET.

Если вы можете подключиться и попасть в точку останова путем выбора пункта Подключиться к процессу, но не путем выбора Отладка>Начать отладку или нажатия клавиши F5, скорее всего, в свойствах проекта неправильно задан параметр. Если вы используете файл HOSTS, также проверьте правильность его настройки.

Настройка отладки в файле web.config

ASP.NET проекты имеют web.config файлы по умолчанию, содержащие сведения о конфигурации приложения и запуске, включая параметры отладки. Файлы web.config должны быть правильно настроены для отладки. Параметры свойств в предыдущих разделах обновляют web.config файлы, но их также можно настроить вручную.

Чтобы вручную настроить web.config файл для отладки, выполните следующие действия.

1. В Visual Studio откройте файл проекта web.config ASP.NET.

2. Web.config представляет собой XML-файл, поэтому содержит вложенные разделы, помеченные тегами. Найдите раздел configuration/system.web/compilation. (Если элемент compilation не существует, создайте его.)

3. Убедитесь, что атрибут debug в элементе compilation имеет значение true. (Если в элементе compilation отсутствует атрибут debug, добавьте его и установите для него значение true.)

   Если вместо сервера IIS Express по умолчанию вы используете локальный сервер IIS, убедитесь, что значение атрибута targetFramework в элементе compilation соответствует платформе на сервере IIS.

   Элемент compilation web.config файла должен выглядеть следующим образом:

   Примечание.

   Этот пример является частичным web.config файлом. Обычно в элементах configuration и system.web имеются дополнительные разделы XML, а элемент compilation может также содержать другие атрибуты и элементы.

   <configuration>
      ...
      <system.web>
          <compilation  debug="true"  targetFramework="4.6.1" ... >
             ...
          </compilation>
      </system.web>
   </configuration>
   

ASP.NET автоматически обнаруживает все изменения web.config в файлах и применяет новые параметры конфигурации. Не нужно перезагружать компьютер или сервер IIS, чтобы изменения вступили в силу.

Веб-сайт может содержать несколько виртуальных каталогов и подкаталогов с файлами web.config в каждом из них. ASP.NET приложения наследуют параметры конфигурации из web.config файлов на более высоких уровнях в ПУТИ URL-адреса. web.config Иерархические параметры файлов применяются ко всем приложениям ASP.NET под ними в иерархии. Задание другой конфигурации в web.config файле ниже в иерархии переопределяет параметры в более высоком файле.

Например, если вы указываете debug="true" в www.microsoft.com/aaa/web.config, любое приложение в aaa папке или в любой вложенной папке aaa наследует этот параметр, за исключением случаев, если одно из этих приложений переопределяет параметр с собственным web.config файлом.

Связанный контент

• Отладка ASP.NET: системные требования
• Практическое руководство. Выполнение рабочего процесса с учетной записью пользователя
• Практическое руководство. Поиск имени процесса ASP.NET
• Отладка развернутых веб-приложений
• Практическое руководство. Отладка исключений ASP.NET
• Отладка веб-приложений: ошибки и устранение неполадок