Меню

настройка iis express visual studio

Поддержка служб IIS во время разработки в Visual Studio для ASP.NET Core Development-time IIS support in Visual Studio for ASP.NET Core

В этой статье описаны поддерживаемые в Visual Studio возможности для отладки приложений ASP.NET Core, выполняющихся в службах IIS в Windows Server. This article describes Visual Studio support for debugging ASP.NET Core apps running with IIS on Windows Server. Также здесь приведены пошаговые инструкции по включению этого сценария и настройке проекта. This topic walks through enabling this scenario and setting up a project.

Предварительные требования Prerequisites

  • Visual Studio для Windows Visual Studio for Windows
  • Рабочая нагрузка ASP.NET и веб-разработкаASP.NET and web development workload
  • Рабочая нагрузка Кроссплатформенная разработка .NET Core.NET Core cross-platform development workload
  • Сертификат безопасности X.509 (для поддержки HTTPS) X.509 security certificate (for HTTPS support)

Активация IIS Enable IIS

  1. В Windows последовательно выберите Панель управления >Программы >Программы и компоненты >Включение или отключение компонентов Windows (в левой части экрана). In Windows, navigate to Control Panel >Programs >Programs and Features >Turn Windows features on or off (left side of the screen).
  2. Установите флажок Службы IIS. Select the Internet Information Services check box. Нажмите кнопку ОК. Select OK.

Для установки служб IIS, возможно, потребуется перезагрузить компьютер. The IIS installation may require a system restart.

Настройка IIS Configure IIS

В службах IIS нужно настроить веб-сайт со следующими характеристиками: IIS must have a website configured with the following:

  • Имя узла. Обычно используется Веб-сайт по умолчанию со значением localhost , заданным параметру Имя узла. Host name – Typically, the Default Web Site is used with a Host name of localhost . Но можно также задать любой допустимый веб-сайт IIS с уникальным именем узла. However, any valid IIS website with a unique host name works.
  • Привязка сайтаSite Binding
    • Для приложений, которым требуется протокол HTTPS, создайте привязку к порту 443 с помощью сертификата. For apps that require HTTPS, create a binding to port 443 with a certificate. Обычно используется сертификат разработки IIS Express, но подойдет и любой другой действительный сертификат. Typically, the IIS Express Development Certificate is used, but any valid certificate works.
    • Для приложений, использующих протокол HTTP, подтвердите привязку к порту 80 или создайте привязку к порту 80 для нового сайта. For apps that use HTTP, confirm the existence of a binding to post 80 or create a binding to port 80 for a new site.
    • Используйте одну привязку либо для HTTP, либо для HTTPS. Use a single binding for either HTTP or HTTPS. Одновременная привязка к портам HTTP и HTTPS не поддерживается.Binding to both HTTP and HTTPS ports simultaneously isn’t supported.

Включение поддержки служб IIS в Visual Studio во время разработки Enable development-time IIS support in Visual Studio

Запустите установщик Visual Studio. Launch the Visual Studio installer.

Выберите Изменить в установщике программы Visual Studio, которую планируется использовать для поддержки IIS во время разработки. Select Modify for the Visual Studio installation that you plan to use for IIS development-time support.

Для рабочей нагрузки ASP.NET и разработка веб-приложений найдите и установите компонент Поддержка времени разработки в IIS. For the ASP.NET and web development workload, locate and install the Development time IIS support component.

Компонент находится в разделе Дополнительно под пунктом Поддержка времени разработки в IIS на панели Сведения об установке справа от рабочих нагрузок. The component is listed in the Optional section under Development time IIS support in the Installation details panel to the right of the workloads. Этот компонент выполнит установку модуля ASP.NET Core, который является собственным модулем IIS, необходимым для запуска приложений ASP.NET Core со службами IIS. The component installs the ASP.NET Core Module, which is a native IIS module required to run ASP.NET Core apps with IIS.

Настройка проекта Configure the project

Перенаправление HTTPS HTTPS redirection

Если новому проекту требуется протокол HTTPS, установите флажок Configure for HTTPS (Настроить для HTTPS) в окне Создать веб-приложение ASP.NET Core. For a new project that requires HTTPS, select the check box to Configure for HTTPS in the Create a new ASP.NET Core Web Application window. Установка флажка добавляет ПО промежуточного слоя перенаправления HTTPS и HSTS в приложение при его создании. Selecting the check box adds HTTPS Redirection and HSTS Middleware to the app when it’s created.

Если существующему проекту требуется протокол HTTPS, используйте ПО промежуточного слоя перенаправления HTTPS и HSTS в Startup.Configure . For an existing project that requires HTTPS, use HTTPS Redirection and HSTS Middleware in Startup.Configure . Для получения дополнительной информации см. Принудительное применение HTTPS в ASP.NET Core. For more information, see Принудительное применение HTTPS в ASP.NET Core.

Читайте также:  настройка dell inspiron 7110

Для проекта, который использует протокол HTTP, поддержку ПО промежуточного слоя перенаправления HTTPS и HSTS задавать не нужно. For a project that uses HTTP, HTTPS Redirection and HSTS Middleware aren’t added to the app. Настройка приложения не требуется. No app configuration is required.

Профиль запуска служб IIS IIS launch profile

Создайте новый профиль запуска, чтобы добавить поддержку IIS во время разработки. Create a new launch profile to add development-time IIS support:

В обозревателе решений щелкните проект правой кнопкой мыши. Right-click the project in Solution Explorer. Выберите пункт Свойства. Select Properties. Откройте вкладку Отладка. Open the Debug tab.

В разделе Профиль нажмите кнопку Новый. For Profile, select the New button. Во всплывающем окне присвойте новому профилю имя IIS. Name the profile «IIS» in the popup window. Нажмите кнопку ОК, чтобы создать проект. Select OK to create the profile.

В поле Запуск выберите из списка значение IIS. For the Launch setting, select IIS from the list.

Установите флажок Запуск браузера и укажите URL-адрес конечной точки. Select the check box for Launch browser and provide the endpoint URL.

Если приложению требуется протокол HTTPS, используйте конечную точку HTTPS ( https:// ). When the app requires HTTPS, use an HTTPS endpoint ( https:// ). Для протокола HTTP используйте конечную точку HTTP ( http:// ). For HTTP, use an HTTP ( http:// ) endpoint.

Укажите то же имя узла и тот же порт, как в выполненной ранее настройке IIS. Обычно это localhost . Provide the same host name and port as the IIS configuration specified earlier uses, typically localhost .

Укажите имя приложения в конце URL-адреса. Provide the name of the app at the end of the URL.

Например https://localhost/WebApplication1 (HTTPS) или http://localhost/WebApplication1 (HTTP) являются действительными URL-адресами конечной точки. For example, https://localhost/WebApplication1 (HTTPS) or http://localhost/WebApplication1 (HTTP) are valid endpoint URLs.

В разделе Переменные среды нажмите кнопку Добавить. In the Environment variables section, select the Add button. Для переменной среды задайте имя ASPNETCORE_ENVIRONMENT и значение Development . Provide an environment variable with a Name of ASPNETCORE_ENVIRONMENT and a Value of Development .

В области Параметры веб-сервера в поле URL-адрес приложения задайте значение, соответствующее URL-адресу конечной точки в поле Запуск браузера. In the Web Server Settings area, set the App URL to the same value used for the Launch browser endpoint URL.

Сохраните профиль. Save the profile.

Если Visual Studio не используется, можно вручную добавить профиль запуска в файл launchSettings.json в папке Properties. When not using Visual Studio, manually add a launch profile to the launchSettings.json file in the Properties folder. В следующем примере настраивается профиль для использования протокола HTTPS. The following example configures the profile to use the HTTPS protocol:

Убедитесь, что конечные точки applicationUrl и launchUrl совпадают и используют тот же протокол (HTTP или HTTPS), что и конфигурация привязки IIS. Confirm that the applicationUrl and launchUrl endpoints match and use the same protocol as the IIS binding configuration, either HTTP or HTTPS.

Запуск проекта Run the project

Запустите Visual Studio от имени администратора. Run Visual Studio as an administrator:

  • Убедитесь, что для раскрывающегося списка с конфигурацией сборки построения выбрано значение Отладка. Confirm that the build configuration drop-down list is set to Debug.
  • Настройте кнопку Начать отладку на профиль IIS и нажмите ее для запуска приложения. Set the Start Debugging button to the IIS profile and select the button to start the app.

Если вы вошли в Visual Studio без прав администратора, возможно, потребуется перезапуск. Visual Studio may prompt a restart if not running as an administrator. Перезапустите Visual Studio при появлении соответствующего запроса. If prompted, restart Visual Studio.

Если используется сертификат разработки без доверия, возможно, потребуется создать исключение для этого ненадежного сертификата по запросу в браузере. If an untrusted development certificate is used, the browser may require you to create an exception for the untrusted certificate.

Отладка конфигурации сборки выпуска с использованием функции Только мой код и оптимизации компилятора приводит к ограничению возможностей. Debugging a Release build configuration with Just My Code and compiler optimizations results in a degraded experience. Например, точки останова не будут достигнуты. For example, break points aren’t hit.

Читайте также:  micro minimosd подключение прошивка и настройка под cleanflight

Дополнительные ресурсы Additional resources

В этой статье описаны поддерживаемые в Visual Studio возможности для отладки приложений ASP.NET Core, выполняющихся в службах IIS в Windows Server. This article describes Visual Studio support for debugging ASP.NET Core apps running with IIS on Windows Server. Также здесь приведены пошаговые инструкции по включению этого сценария и настройке проекта. This topic walks through enabling this scenario and setting up a project.

Предварительные требования Prerequisites

  • Visual Studio для Windows Visual Studio for Windows
  • Рабочая нагрузка ASP.NET и веб-разработкаASP.NET and web development workload
  • Рабочая нагрузка Кроссплатформенная разработка .NET Core.NET Core cross-platform development workload
  • Сертификат безопасности X.509 (для поддержки HTTPS) X.509 security certificate (for HTTPS support)

Активация IIS Enable IIS

  1. В Windows последовательно выберите Панель управления >Программы >Программы и компоненты >Включение или отключение компонентов Windows (в левой части экрана). In Windows, navigate to Control Panel >Programs >Programs and Features >Turn Windows features on or off (left side of the screen).
  2. Установите флажок Службы IIS. Select the Internet Information Services check box. Нажмите кнопку ОК. Select OK.

Для установки служб IIS, возможно, потребуется перезагрузить компьютер. The IIS installation may require a system restart.

Настройка IIS Configure IIS

В службах IIS нужно настроить веб-сайт со следующими характеристиками: IIS must have a website configured with the following:

  • Имя узла. Обычно используется Веб-сайт по умолчанию со значением localhost , заданным параметру Имя узла. Host name – Typically, the Default Web Site is used with a Host name of localhost . Но можно также задать любой допустимый веб-сайт IIS с уникальным именем узла. However, any valid IIS website with a unique host name works.
  • Привязка сайтаSite Binding
    • Для приложений, которым требуется протокол HTTPS, создайте привязку к порту 443 с помощью сертификата. For apps that require HTTPS, create a binding to port 443 with a certificate. Обычно используется сертификат разработки IIS Express, но подойдет и любой другой действительный сертификат. Typically, the IIS Express Development Certificate is used, but any valid certificate works.
    • Для приложений, использующих протокол HTTP, подтвердите привязку к порту 80 или создайте привязку к порту 80 для нового сайта. For apps that use HTTP, confirm the existence of a binding to post 80 or create a binding to port 80 for a new site.
    • Используйте одну привязку либо для HTTP, либо для HTTPS. Use a single binding for either HTTP or HTTPS. Одновременная привязка к портам HTTP и HTTPS не поддерживается.Binding to both HTTP and HTTPS ports simultaneously isn’t supported.

Включение поддержки служб IIS в Visual Studio во время разработки Enable development-time IIS support in Visual Studio

Запустите установщик Visual Studio. Launch the Visual Studio installer.

Выберите Изменить в установщике программы Visual Studio, которую планируется использовать для поддержки IIS во время разработки. Select Modify for the Visual Studio installation that you plan to use for IIS development-time support.

Для рабочей нагрузки ASP.NET и разработка веб-приложений найдите и установите компонент Поддержка времени разработки в IIS. For the ASP.NET and web development workload, locate and install the Development time IIS support component.

Компонент находится в разделе Дополнительно под пунктом Поддержка времени разработки в IIS на панели Сведения об установке справа от рабочих нагрузок. The component is listed in the Optional section under Development time IIS support in the Installation details panel to the right of the workloads. Этот компонент выполнит установку модуля ASP.NET Core, который является собственным модулем IIS, необходимым для запуска приложений ASP.NET Core со службами IIS. The component installs the ASP.NET Core Module, which is a native IIS module required to run ASP.NET Core apps with IIS.

Настройка проекта Configure the project

Перенаправление HTTPS HTTPS redirection

Если новому проекту требуется протокол HTTPS, установите флажок Configure for HTTPS (Настроить для HTTPS) в окне Создать веб-приложение ASP.NET Core. For a new project that requires HTTPS, select the check box to Configure for HTTPS in the Create a new ASP.NET Core Web Application window. Установка флажка добавляет ПО промежуточного слоя перенаправления HTTPS и HSTS в приложение при его создании. Selecting the check box adds HTTPS Redirection and HSTS Middleware to the app when it’s created.

Если существующему проекту требуется протокол HTTPS, используйте ПО промежуточного слоя перенаправления HTTPS и HSTS в Startup.Configure . For an existing project that requires HTTPS, use HTTPS Redirection and HSTS Middleware in Startup.Configure . Для получения дополнительной информации см. Принудительное применение HTTPS в ASP.NET Core. For more information, see Принудительное применение HTTPS в ASP.NET Core.

Читайте также:  world vision t53 сброс настроек

Для проекта, который использует протокол HTTP, поддержку ПО промежуточного слоя перенаправления HTTPS и HSTS задавать не нужно. For a project that uses HTTP, HTTPS Redirection and HSTS Middleware aren’t added to the app. Настройка приложения не требуется. No app configuration is required.

Профиль запуска служб IIS IIS launch profile

Создайте новый профиль запуска, чтобы добавить поддержку IIS во время разработки. Create a new launch profile to add development-time IIS support:

В обозревателе решений щелкните проект правой кнопкой мыши. Right-click the project in Solution Explorer. Выберите пункт Свойства. Select Properties. Откройте вкладку Отладка. Open the Debug tab.

В разделе Профиль нажмите кнопку Новый. For Profile, select the New button. Во всплывающем окне присвойте новому профилю имя IIS. Name the profile «IIS» in the popup window. Нажмите кнопку ОК, чтобы создать проект. Select OK to create the profile.

В поле Запуск выберите из списка значение IIS. For the Launch setting, select IIS from the list.

Установите флажок Запуск браузера и укажите URL-адрес конечной точки. Select the check box for Launch browser and provide the endpoint URL.

Если приложению требуется протокол HTTPS, используйте конечную точку HTTPS ( https:// ). When the app requires HTTPS, use an HTTPS endpoint ( https:// ). Для протокола HTTP используйте конечную точку HTTP ( http:// ). For HTTP, use an HTTP ( http:// ) endpoint.

Укажите то же имя узла и тот же порт, как в выполненной ранее настройке IIS. Обычно это localhost . Provide the same host name and port as the IIS configuration specified earlier uses, typically localhost .

Укажите имя приложения в конце URL-адреса. Provide the name of the app at the end of the URL.

Например https://localhost/WebApplication1 (HTTPS) или http://localhost/WebApplication1 (HTTP) являются действительными URL-адресами конечной точки. For example, https://localhost/WebApplication1 (HTTPS) or http://localhost/WebApplication1 (HTTP) are valid endpoint URLs.

В разделе Переменные среды нажмите кнопку Добавить. In the Environment variables section, select the Add button. Для переменной среды задайте имя ASPNETCORE_ENVIRONMENT и значение Development . Provide an environment variable with a Name of ASPNETCORE_ENVIRONMENT and a Value of Development .

В области Параметры веб-сервера в поле URL-адрес приложения задайте значение, соответствующее URL-адресу конечной точки в поле Запуск браузера. In the Web Server Settings area, set the App URL to the same value used for the Launch browser endpoint URL.

Сохраните профиль. Save the profile.

Если Visual Studio не используется, можно вручную добавить профиль запуска в файл launchSettings.json в папке Properties. When not using Visual Studio, manually add a launch profile to the launchSettings.json file in the Properties folder. В следующем примере настраивается профиль для использования протокола HTTPS. The following example configures the profile to use the HTTPS protocol:

Убедитесь, что конечные точки applicationUrl и launchUrl совпадают и используют тот же протокол (HTTP или HTTPS), что и конфигурация привязки IIS. Confirm that the applicationUrl and launchUrl endpoints match and use the same protocol as the IIS binding configuration, either HTTP or HTTPS.

Запуск проекта Run the project

Запустите Visual Studio от имени администратора. Run Visual Studio as an administrator:

  • Убедитесь, что для раскрывающегося списка с конфигурацией сборки построения выбрано значение Отладка. Confirm that the build configuration drop-down list is set to Debug.
  • Настройте кнопку Начать отладку на профиль IIS и нажмите ее для запуска приложения. Set the Start Debugging button to the IIS profile and select the button to start the app.

Если вы вошли в Visual Studio без прав администратора, возможно, потребуется перезапуск. Visual Studio may prompt a restart if not running as an administrator. Перезапустите Visual Studio при появлении соответствующего запроса. If prompted, restart Visual Studio.

Если используется сертификат разработки без доверия, возможно, потребуется создать исключение для этого ненадежного сертификата по запросу в браузере. If an untrusted development certificate is used, the browser may require you to create an exception for the untrusted certificate.

Отладка конфигурации сборки выпуска с использованием функции Только мой код и оптимизации компилятора приводит к ограничению возможностей. Debugging a Release build configuration with Just My Code and compiler optimizations results in a degraded experience. Например, точки останова не будут достигнуты. For example, break points aren’t hit.

источник