Начало работы с добавочными ASP.NET для миграции ASP.NET Core

Для крупной миграции рекомендуется настроить приложение ASP.NET Core, которое прокси-серверы будут выполняться в исходном платформа .NET Framework приложении. Новое приложение с поддержкой прокси-сервера отображается на следующем рисунке:

start migrating routes

Чтобы понять, как этот подход полезен в процессе миграции, ознакомьтесь с добавочными ASP.NET для миграции ASP.NET Core. В остальной части этой статьи приведены шаги по продолжению добавочной миграции.

Настройка основного проекта ASP.NET

Сведения о ASP.NET приложениях MVC и веб-API см. в статье Об обновлении с ASP.NET MVC и веб-API до ASP.NET Core MVC. Сведения о приложениях ASP платформа .NET Framework веб-формы см. в статье "Сведения об обновлении с ASP.NET веб-формы до ASP.NET Core".

Обновление вспомогательных библиотек

Если у вас есть вспомогательные библиотеки в решении, которые необходимо использовать, они должны быть обновлены до .NET Standard 2.0, если это возможно. Помощник по обновлению — это отличный инструмент для этого. Если библиотеки не могут нацелиться на .NET Standard, можно использовать .NET 6 или более поздней версии вместе с целевым объектом платформа .NET Framework в исходном проекте или в новом проекте вместе с исходным.

Адаптеры можно использовать в этих библиотеках, System.Web.HttpContext чтобы обеспечить поддержку использования в библиотеках классов. Чтобы включить System.Web.HttpContext использование в библиотеке, выполните приведенные действия.

  1. Удаление ссылки на System.Web файл проекта
  2. Microsoft.AspNetCore.SystemWebAdapters Добавление пакета
  3. Включите многоцелевой объект и добавьте целевой объект .NET 6 или более поздней версии или преобразуйте проект в .NET Standard 2.0.
  4. Убедитесь, что целевая платформа поддерживает .NET Core. Многоцелевой выбор можно использовать, если .NET Standard 2.0 недостаточно

На этом шаге может потребоваться изменить ряд проектов в зависимости от структуры решения. Помощник по обновлению поможет определить, какие из них необходимо изменить и автоматизировать ряд шагов в процессе.

Включение поддержки сеансов

Сеанс — это часто используемая функция ASP.NET, которая использует имя с функцией в ASP.NET Core, интерфейсы API значительно отличаются. См. документацию по поддержке сеансов.

Включение поддержки общей проверки подлинности

Можно совместно использовать проверку подлинности между исходным приложением ASP.NET и новым приложением ASP.NET Core с помощью System.Web функции удаленной проверки подлинности адаптеров. Эта функция позволяет приложению ASP.NET Core отложить проверку подлинности в приложение ASP.NET. Дополнительные сведения см. в документации по подключению к удаленному приложению и удаленной проверке подлинности.

Общие рекомендации по использованию

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