다음을 통해 공유


.NET 5의 호환성이 손상되는 변경

앱을 .NET 5로 마이그레이션하는 경우 여기에 나열된 호환성이 손상되는 변경이 영향을 줄 수 있습니다. 변경 내용은 ASP.NET Core 또는 암호화와 같은 기술 영역별로 그룹화됩니다.

이 문서에서는 각 호환성이 손상되는 변경이 이진 파일 호환인지 또는 원본 호환인지 여부를 나타냅니다.

  • 이진 파일 호환 - 기존 이진 파일은 다시 컴파일 없이 성공적으로 로드 및 실행되며 런타임 동작은 변경되지 않습니다.
  • 원본 호환 - 새 런타임을 대상으로 하거나 새 SDK 또는 구성 요소를 사용할 때 소스 코드는 변경 없이 성공적으로 컴파일됩니다.

ASP.NET Core

타이틀 이진 호환 가능 소스 호환 가능
ASP.NET Core 앱이 따옴표 붙은 숫자를 역직렬화함 ✔️
AzureAD.UI 및 AzureADB2C.UI API가 사용되지 않음 ✔️
BinaryFormatter serialization 메서드가 사용되지 않음 ✔️
엔드포인트 라우팅의 리소스가 HttpContext임 ✔️
Microsoft 접두사가 있는 Azure 통합 패키지가 제거됨 ✔️
Blazor: Blazor 앱에서 경로 우선순위 논리가 변경됨 ✔️
Blazor: 업데이트된 브라우저 지원 ✔️ ✔️
Blazor: 컴파일러에 의해 잘린 무효 공백 ✔️
Blazor: JSObjectReference 및 JSInProcessObjectReference 형식이 internal임 ✔️
Blazor: NuGet 패키지의 대상 프레임워크가 변경됨 ✔️
Blazor: ProtectedBrowserStorage 기능을 공유 프레임워크로 이동함 ✔️
Blazor: RenderTreeFrame 읽기 전용 퍼블릭 필드가 이제 속성임 ✔️
Blazor: 정적 웹 자산에 대한 유효성 검사 논리를 업데이트함 ✔️
브라우저에서 지원되지 않는 암호화 API ✔️
확장: 패키지 참조 변경 ✔️
Kestrel 및 IIS BadHttpRequestException 형식이 사용되지 않음 ✔️
IHttpClientFactory 로그 정수 상태 코드에서 생성된 HttpClient 인스턴스 ✔️
HttpSys: 클라이언트 인증서 재협상을 기본적으로 사용 안 함 ✔️
IIS: UrlRewrite 미들웨어 쿼리 문자열이 유지됨 ✔️
Kestrel: 기본적으로 검색되는 구성 변경 ✔️
Kestrel: 지원되는 기본 TLS 프로토콜 버전 변경됨 ✔️
Kestrel: 호환되지 않는 Windows 버전에서 TLS를 통한 HTTP/2 사용 안 함 ✔️ ✔️
Kestrel: 사용되지 않는 것으로 표시된 Libuv 전송 ✔️
ConsoleLoggerOptions에서 사용되지 않는 속성 ✔️
ResourceManagerWithCultureStringLocalizer 클래스 및 WithCulture 인터페이스 멤버가 제거됨 ✔️
Pubternal API가 제거됨 ✔️
요청 지역화 미들웨어에서 사용되지 않는 생성자가 제거됨 ✔️
미들웨어: 사용되지 않는 것으로 표시된 데이터베이스 오류 페이지 ✔️
예외 처리기 미들웨어가 원래 예외를 throw함 ✔️ ✔️
ObjectModelValidator가 Validate의 새 오버로드를 호출함 ✔️
쿠키 이름 인코딩이 제거됨 ✔️
IdentityModel NuGet 패키지 버전이 업데이트됨 ✔️
SignalR: MessagePack 허브 프로토콜 옵션 형식이 변경됨 ✔️
SignalR: MessagePack 허브 프로토콜이 이동됨 ✔️
UseSignalR 및 UseConnections 메서드가 제거됨 ✔️
CSV 콘텐츠 형식이 표준 규격으로 변경됨 ✔️

코드 분석

타이틀 이진 호환 가능 소스 호환 가능
CA1416 경고 ✔️
CA1417 경고 ✔️
CA1831 경고 ✔️
CA2013 경고 ✔️
CA2014 경고 ✔️
CA2015 경고 ✔️
CA2200 경고 ✔️
CA2247 경고 ✔️

핵심 .NET 라이브러리

타이틀 이진 호환 가능 소스 호환 가능
단일 파일 게시를 위한 어셈블리 관련 API 변경 ✔️
BinaryFormatter serialization 메서드가 사용되지 않음 ✔️
코드 액세스 보안 API가 사용되지 않음 ✔️
CreateCounterSetInstance가 InvalidOperationException을 throw함 ✔️
기본 ActivityIdFormat이 W3C임 ✔️
Environment.OSVersion이 올바른 버전을 반환함 ✔️
FrameworkDescription의 값이 .NET Core가 아니라 .NET임 ✔️
GAC API가 사용되지 않음 ✔️
하드웨어 내장 IsSupported 검사 ✔️
IntPtr 및 UIntPtr에서 IFormattable 구현 ✔️
LastIndexOf가 빈 검색 문자열을 처리함 ✔️
Unix에서 ASCII가 아닌 문자를 포함하는 URI 경로 ✔️
기본이 아닌 진단 ID를 사용하는 API 사용되지 않음 ✔️
ConsoleLoggerOptions에서 사용되지 않는 속성 ✔️
LINQ OrderBy.First의 복잡성 ✔️
OSPlatform 특성이 제거되었거나 특성 이름이 바뀜 ✔️
Microsoft.DotNet.PlatformAbstractions 패키지가 제거됨 ✔️
PrincipalPermissionAttribute가 사용되지 않음 ✔️
미리 보기 버전에서 매개 변수 이름 변경 ✔️
참조 어셈블리의 매개 변수 이름 변경 ✔️
원격 API가 사용되지 않음 ✔️
Activity.Tags 목록의 순서가 반대로 표시됨 ✔️
SSE 및 SSE2 비교 메서드가 NaN을 처리함 ✔️
Thread.Abort는 사용되지 않음 ✔️
Unix에서 UNC 경로의 URI 인식 ✔️
UTF-7 코드 경로가 사용되지 않음 ✔️
Vector2.Lerp 및 Vector4.Lerp의 동작 변경 ✔️
Vector<T>가 NotSupportedException을 throw함 ✔️

암호화

타이틀 이진 호환 가능 소스 호환 가능
브라우저에서 지원되지 않는 암호화 API ✔️
Cryptography.Oid가 init 전용임 ✔️
Linux의 기본 TLS 암호 그룹 ✔️
암호화 추상화에 대한 Create() 오버 로드가 사용되지 않음 ✔️
기본 FeedbackSize 값이 변경됨 ✔️

Entity Framework Core

EF Core 5.0의 호환성이 손상되는 변경

전역화

타이틀 이진 호환 가능 소스 호환 가능
Windows에서 ICU 라이브러리 사용 ✔️
StringInfo 및 TextElementEnumerator가 UAX29 규격임 ✔️
라틴어-1 문자의 유니코드 범주가 변경됨 ✔️
TextInfo.ListSeparator 값이 변경됨 ✔️

Interop

타이틀 이진 호환 가능 소스 호환 가능
WinRT에 대한 지원이 제거됨 ✔️
RCW를 InterfaceIsIInspectable로 캐스팅하면 예외가 throw됨 ✔️
비 Windows 플랫폼에서 A/W 접미사 검색 안 함 ✔️

네트워킹

타이틀 이진 호환 가능 소스 호환 가능
쿠키 경로 처리가 RFC 6265를 준수함 ✔️
SendToAsync 호출 후 LocalEndPoint가 업데이트됨 ✔️
MulticastOption.Group에서 null을 허용하지 않음 ✔️
스트림이 연속 Begin 작업을 허용함 ✔️
.NET 런타임에서 WinHttpHandler 제거됨 ✔️

SDK

타이틀 이진 호환 가능 소스 호환 가능
기본적으로 Directory.Packages.props 파일을 가져옴 ✔️
실행 파일 프로젝트에서 일치하지 않는 실행 파일을 참조할 때 발생하는 오류 ✔️
FrameworkReference가 Windows SDK에 대한 WindowsSdkPackageVersion으로 바뀌었음 ✔️
NETCOREAPP3_1 전처리기 기호가 정의되지 않음 ✔️
OutputType이 WinExe로 설정됨 ✔️
PublishDepsFilePath 동작 변경 ✔️
netcoreapp에서 net으로 TargetFramework 변경 ✔️
WinForms 및 WPF 앱이 Microsoft.NET.Sdk를 사용함 ✔️

보안

타이틀 이진 호환 가능 소스 호환 가능
코드 액세스 보안 API가 사용되지 않음 ✔️
PrincipalPermissionAttribute가 사용되지 않음 ✔️
UTF-7 코드 경로가 사용되지 않음 ✔️

직렬화

타이틀 이진 호환 가능 소스 호환 가능
BinaryFormatter.Deserialize가 예외를 다시 래핑함 ✔️
JsonSerializer.Deserialize에는 단일 문자열이 필요함 ✔️
ASP.NET Core 앱이 따옴표 붙은 숫자를 역직렬화함 ✔️
JsonSerializer.Serialize가 ArgumentNullException을 throw함 ✔️
역직렬화에 사용되지 않는 비공용 매개 변수가 없는 생성자 ✔️
키-값 쌍을 직렬화할 때 옵션이 적용됨 ✔️

Windows Forms

타이틀 이진 호환 가능 소스 호환 가능
네이티브 코드는 Windows Forms 개체에 액세스하지 못함 ✔️
OutputType이 WinExe로 설정됨 ✔️
DataGridView가 사용자 지정 글꼴을 다시 설정하지 않음 ✔️
메서드가 ArgumentException을 throw함 ✔️
메서드가 ArgumentNullException을 throw함 ✔️
속성이 ArgumentOutOfRangeException을 throw함 ✔️
TextFormatFlags.ModifyString은 사용되지 않음 ✔️
DataGridView API가 InvalidOperationException을 throw함 ✔️
WinForms 앱이 Microsoft.NET.Sdk를 사용함 ✔️
상태 표시줄 컨트롤 제거 ✔️

WPF

타이틀 이진 호환 가능 소스 호환 가능
OutputType이 WinExe로 설정됨 ✔️
WPF 앱이 Microsoft.NET.Sdk를 사용함 ✔️

참고 항목