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

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

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

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

ASP.NET Core

ASP.NET Core 6의 주요 변경 내용을 참조하세요.

컨테이너

타이틀 이진 호환 가능 소스 호환 가능
컨테이너 이미지의 기본 콘솔 로거 서식 지정 ✔️ ❌

.NET 6 컨테이너의 기타 호환성이 손상되는 변경에 대한 자세한 내용은 .NET 6 컨테이너 릴리스 정보를 참조하세요.

핵심 .NET 라이브러리

타이틀 이진 호환 가능 소스 호환 가능
기본이 아닌 진단 ID를 사용하는 API 사용되지 않음 ✔️ ❌
Nullable 참조 형식 주석의 변경 내용 ✔️ ❌
디버그 메서드의 조건부 문자열 평가 ✔️ ❌
Windows의 Environment.ProcessorCount 동작 ✔️ ❌
EventSource 콜백 동작 ✔️ ✔️
Unix의 File.Replace는 Windows와 일치하도록 예외를 throw함 ✔️ ❌
파일 스트림이 Unix에서 공유 잠금을 사용하여 파일을 잠금 ❌ ✔️
FileStream이 더 이상 파일 오프셋을 OS와 동기화하지 않음 ❌ ❌
ReadAsync 또는 WriteAsync 완료 후 FileStream.Position 업데이트 ❌ ❌
사용 중지 API에 대한 새 진단 ID ✔️ ❌
새 System.Linq.Queryable 메서드 오버로드 ✔️ ❌
패키지에서 삭제된 이전 프레임워크 버전 ❌ ✔️
매개 변수 이름이 변경됨 ✔️ ❌
스트림 파생 형식의 매개 변수 이름 ✔️ ❌
DeflateStream, GZipStream 및 CryptoStream의 부분 및 0바이트 읽기 ✔️ ❌
Windows 읽기 전용 파일에 타임스탬프 설정 ❌ ✔️
표준 숫자 형식 구문 분석 정밀도 ✔️ ❌
인터페이스의 정적 추상 멤버 ❌ ✔️
StringBuilder.Append 오버로드 및 평가 순서 ❌ ✔️
강력한 이름 API가 PlatformNotSupportedException을 throw함 ❌ ✔️
System.Drawing.Common, Windows에서만 지원 ❌ ❌
System.Security.SecurityContext가 사용되지 않는 것으로 표시됨 ✔️ ❌
Task.FromResult가 싱글톤을 반환할 수 있음 ❌ ✔️
BackgroundService에서 처리되지 않은 예외 ✔️ ❌

암호화

타이틀 이진 호환 가능 소스 호환 가능
CreateEncryptor 메서드가 잘못된 피드백 크기에 대해 예외를 throw함 ❌ ✔️

배포

타이틀 이진 호환 가능 소스 호환 가능
64비트 Windows의 x86 호스트 경로 ✔️ ✔️

Entity Framework Core (엔티티 프레임워크 코어)

EF Core 6의 주요 변경 사항을 참조하세요.

확장

타이틀 이진 호환 가능 소스 호환 가능
AddProvider가 null이 아닌 공급자를 확인함 ✔️ ❌
FileConfigurationProvider.Load가 InvalidDataException을 throw함 ✔️ ❌
반복되는 XML 요소에 인덱스가 포함됨 ❌ ✔️
삭제한 ServiceProvider 분석을 통해 예외를 throw함 ✔️ ❌

전역화

타이틀 이진 호환 가능 소스 호환 가능
세계화 고정 모드의 문화권 만들기 및 대/소문자 매핑

Interop

타이틀 이진 호환 가능 소스 호환 가능
인터페이스의 정적 추상 멤버 ❌ ✔️

JIT 컴파일러

타이틀 이진 호환 가능 소스 호환 가능
ECMA-335에 따라 호출 인수 강제 변환 ✔️ ✔️

네트워킹

타이틀 이진 호환 가능 소스 호환 가능
Kerberos 및 Negotiate를 위해 SPN에서 포트가 제거됨 ❌ ✔️
WebRequest, WebClient, ServicePoint는 사용되지 않음 ✔️ ❌

SDK (소프트웨어 개발 키트)

타이틀 이진 호환 가능 소스 호환 가능
-p에 대한 dotnet run 옵션은 사용되지 않음 ✔️ ❌
이전 버전에서 지원되지 않는 템플릿의 C# 코드 ✔️ ✔️
EditorConfig 파일이 암시적으로 포함됨 ✔️ ❌
macOS용 apphost 생성 ✔️ ❌
게시 출력의 중복 파일에 대한 오류 생성 ❌ ✔️
GetTargetFrameworkProperties 및 GetNearestTargetFramework가 ProjectReference 프로토콜에서 제거됨 ❌ ✔️
Arm64에 에뮬레이트된 x64의 설치 위치 ✔️ ❌
MSBuild, GetType() 호출 지원 중지
.NET을 사용자 지정 위치에 설치할 수 없음 ✔️ ✔️
OutputType이 WinExe로 자동으로 설정되지 않음 ✔️ ❌
--no-restore를 사용하여 ReadyToRun을 게시하려면 변경이 필요함 ✔️ ❌
runtimeconfig.dev.json 파일이 생성되지 않음 ❌ ✔️
자체 포함이 지정되지 않은 경우 RuntimeIdentifier 경고 ✔️ ❌
루트 폴더의 도구 매니페스트 ✔️ ✔️
.NET 6 SDK의 버전 요구 사항 ✔️ ✔️
.version 파일에 빌드 버전이 포함되어 있음 ✔️ ✔️
IntermediateOutputPath에 참조 어셈블리 쓰기 ❌ ✔️

직렬화

타이틀 이진 호환 가능 소스 호환 가능
DataContractSerializer는 -0을 역직렬화할 때 기호를 유지 ❌ ✔️
TimeSpan에 대한 기본 serialization 형식 ❌ ✔️
IAsyncEnumerable 직렬화 ✔️ ❌
JSON 소스 생성 API 리팩터링 ❌ ✔️
컬렉션 속성의 JsonNumberHandlingAttribute ❌ ✔️
새 JsonSerializer 소스 생성기 오버로드 ❌ ✔️

윈도우 폼즈 (Windows Forms)

타이틀 이진 호환 가능 소스 호환 가능
C# 템플릿이 애플리케이션 부트스트랩을 사용함 ✔️ ❌
선택한 TableLayoutSettings 속성이 InvalidEnumArgumentException을 throw함 ❌ ✔️
DataGridView 관련 API가 이제 InvalidOperationException을 throw함 ❌ ✔️
ListViewGroupCollection 메서드가 새 InvalidOperationException을 throw함 ❌ ✔️
NotifyIcon.Text 최대 텍스트 길이가 늘어남 ❌ ✔️
필요할 때만 호출되는 ScaleControl ✔️ ❌
일부 API가 ArgumentNullException을 throw함 ❌ ✔️
노드가 다른 곳에 할당될 경우 TreeNodeCollection.Item이 예외를 throw함 ❌ ✔️

XML 및 XSLT

타이틀 이진 호환 가능 소스 호환 가능
잘못된 인덱스에 대한 XNodeReader.GetAttribute 동작 ✔️ ❌

참고 항목

  • Last updated on