ASP.NET Core 마이그레이션을 위한 증분 ASP.NET 시작

대규모 마이그레이션의 경우 원래 .NET Framework 앱에 프록시하는 ASP.NET Core 앱을 설정하는 것이 좋습니다. 새 프록시 사용 앱은 다음 이미지에 표시됩니다.

이 방법이 마이그레이션 프로세스 에서 어떻게 도움이 되는지 이해하려면 ASP.NET Core 마이그레이션에 대한 증분 ASP.NET 참조하세요. 이 문서의 나머지 부분에는 증분 마이그레이션을 진행하는 단계가 제공됩니다.

ASP.NET Core 프로젝트 설정

ASP.NET MVC 및 Web API 앱 의 경우 ASP.NET MVC 및 Web API에서 ASP.NET Core MVC로 업그레이드하는 방법을 참조하세요. ASP.NET Framework Web Forms 앱 의 경우 ASP.NET Web Forms에서 ASP.NET Core로 업그레이드하는 방법을 참조하세요.

지원 라이브러리 업그레이드

솔루션에 사용해야 하는 지원 라이브러리가 있다면 가능한 경우 .NET Standard 2.0으로 업그레이드해야 합니다. 업그레이드 도우미를 유용한 도구로 사용할 수 있습니다. 라이브러리가 .NET Standard를 대상으로 할 수 없는 경우 원래 프로젝트의 .NET Framework 대상과 함께 또는 원래 프로젝트와 함께 새 프로젝트에서 .NET 6 이상을 대상으로 지정할 수 있습니다.

이러한 라이브러리에서 어댑터를 사용하여 클래스 라이브러리에서 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이 충분하지 않은 경우 다중 대상 지정을 사용할 수 있습니다.

이 단계에서는 솔루션 구조에 따라 여러 프로젝트를 변경해야 할 수 있습니다. 업그레이드 도우미를 사용하면 프로세스에서 여러 단계를 변경하고 자동화해야 하는 항목을 식별할 수 있습니다.

세션 지원 사용

세션은 API가 매우 다른 ASP.NET Core의 기능과 이름을 공유하는 ASP.NET에서 일반적으로 사용되는 기능입니다. 세션 지원에 대한 설명서를 참조하세요.

공유 인증 지원 사용

System.Web 어댑터 원격 인증 기능을 사용하여 원래 ASP.NET 앱과 새 ASP.NET Core 앱 간에 인증을 공유할 수 있습니다. 이 기능을 사용하면 ASP.NET Core 앱이 ASP.NET 앱에 대한 인증을 연기할 수 있습니다. 자세한 내용은 원격 앱 연결 및 원격 인증 설명서를 참조하세요.

일반 사용 지침

어댑터가 업데이트에 도움이 될 수 있는 ASP.NET 코어와 ASP.NET Core 간에는 여러 가지 차이점이 있습니다. 그러나 일부 비용이 발생하므로 옵트인이 필요한 몇 가지 기능이 있습니다. 조정할 수 없는 동작도 있습니다. 이러한 동작들은 사용 지침을 참조하세요.