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

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

이 문서에서는 각 호환성이 손상되는 변경을 이진 파일 비호환, 원본 비호환 또는 동작 변경으로 분류합니다.

이진 파일 비호환 - 새 런타임이나 구성 요소에 대해 실행할 때 기존 이진 파일의 동작이 크게 변경될 수 있습니다(예: 로드 또는 실행 실패). 그런 경우 다시 컴파일이 필요합니다.
원본 비호환 - 새 SDK 또는 구성 요소를 사용하여 다시 컴파일하거나 새 런타임을 대상으로 하는 경우 기존 소스 코드를 성공적으로 컴파일하려면 원본을 변경해야 할 수도 있습니다.
동작 변경 - 기존 코드와 이진 파일은 런타임 시 다르게 동작할 수 있습니다. 새로운 동작이 바람직하지 않은 경우 기존 코드를 업데이트하고 다시 컴파일해야 합니다.

참고 항목

이 문서는 작성 중입니다. .NET 9의 호환성이 손상되는 변경의 완전한 목록이 아닙니다. 여전히 게시 보류 중인 호환성이 손상되는 변경을 쿼리하려면 .NET의 문제를 참조하세요.

ASP.NET Core

타이틀	변경 형식	도입된 버전
DefaultKeyResolution.ShouldGenerateNewKey의 의미가 변경되었습니다.	동작 변경	미리 보기 3
HostBuilder는 개발 환경에서 ValidateOnBuild/ValidateScopes를 사용하도록 설정함	동작 변경	미리 보기 7

타이틀	변경 형식	도입된 버전
.NET 9 컨테이너 이미지는 더 이상 zlib를 설치하지 않음	동작 변경	미리 보기 7

타이틀	변경 형식	도입된 버전
CompressionLevel을 사용하여 ZipArchiveEntry를 추가하면 ZIP 중앙 디렉터리 헤더 범용 비트 플래그가 설정됨	동작 변경	미리 보기 5
비개방형 제네릭에 대한 UnsafeAccessor 지원이 변경됨	동작 변경	미리 보기 6
사용자 지정 진단 ID를 사용한 API 폐기	원본이 호환되지 않음	미리 보기 16
BigInteger 최대 길이	동작 변경	미리 보기 6
System.Void 배열 형식을 만들 수 없음	동작 변경	미리 보기 1
다음으로 표시된 형식에 대한 기본 `Equals()` 및 `GetHashCode()` throw `InlineArrayAttribute`	동작 변경	미리 보기 6
FromKeyedServicesAttribute는 키가 지정되지 않은 매개 변수를 더 이상 삽입하지 않음	동작 변경	RC 1
IncrementingPollingCounter 초기 콜백은 비동기적임	동작 변경	RC 1
인라인 배열 구조체 크기 제한이 적용됨	동작 변경	미리 보기 1
InMemoryDirectoryInfo는 파일 앞에 rootDir을 추가	동작 변경	미리 보기 1
RuntimeHelpers.GetSubArray가 다른 형식을 반환함	동작 변경	미리 보기 1
빈 환경 변수에 대한 지원	동작 변경	미리 보기 6
ZipArchiveEntry 이름 및 주석은 UTF8 플래그를 따름	동작 변경	RC 1

타이틀	변경 형식	도입된 버전
SafeEvpPKeyHandle.DuplicateHandle은 핸들을 상위 참조함	동작 변경	미리 보기 7
일부 X509Certificate2 및 X509Certificate 생성자는 사용되지 않음	원본이 호환되지 않음	미리 보기 7

타이틀	변경 형식	도입된 버전
사용 중단된 데스크톱 Windows/macOS/Linux MonoVM 런타임 패키지	원본이 호환되지 않음	미리 보기 7

타이틀	변경 형식	도입된 버전
부동 소수점에서 정수로의 변환이 포화 상태임	동작 변경	미리 보기 4
일부 SVE API가 제거됨	원본이 호환되지 않음	RC 2

타이틀	변경 형식	도입된 버전
HttpClientFactory 로깅은 기본적으로 헤더 값을 수정함	동작 변경	RC 1
HttpListenerRequest.UserAgent가 null 허용임	원본이 호환되지 않음	미리 보기 1

타이틀	변경 형식	도입된 버전
`dotnet workload` 명령 출력 변경	동작 변경	미리 보기 1
`installer` 리포지토리 버전이 더 이상 문서화되지 않음	동작 변경	미리 보기 5
터미널 로거가 기본값임	동작 변경	미리 보기 1
.NET Standard 1.x에 대해 내보낸 경고	원본이 호환되지 않음	미리 보기 6

타이틀	변경 형식	도입된 버전
BinaryFormatter는 항상 throw함	동작 변경	미리 보기 6

타이틀	변경 형식	도입된 버전
BindingSource.SortDescriptions가 null을 반환하지 않음	동작 변경	미리 보기 1
Null 허용 여부 주석 변경 내용	원본이 호환되지 않음	미리 보기 1
ComponentDesigner.Initialize가 ArgumentNullException을 throw함	동작 변경	미리 보기 1
DataGridViewRowAccessibleObject.Name 시작 행 인덱스	동작 변경	미리 보기 1
IMsoComponent 지원 옵트인	동작 변경	Preview 2
DataGridView가 null인 경우 예외 없음	동작 변경	미리 보기 1
PictureBox에서 HttpClient 예외 발생	동작 변경	미리 보기 6

타이틀	변경 형식	도입된 버전
`GetXmlNamespaceMaps` 형식 변경	동작 변경/원본 비호환	미리 보기 3