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

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

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

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

참고 항목

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

ASP.NET Core

타이틀	변경 형식	도입된 버전
DefaultKeyResolution.ShouldGenerateNewKey의 의미가 변경되었습니다.	동작 변경	미리 보기 3

타이틀	변경 형식	도입된 버전
사용자 지정 진단 ID를 사용한 API 폐기	원본이 호환되지 않음	미리 보기 1
System.Void 배열 형식을 만들 수 없음	동작 변경	미리 보기 1
인라인 배열 구조체 크기 제한이 적용됨	동작 변경	미리 보기 1
InMemoryDirectoryInfo는 파일 앞에 rootDir을 추가	동작 변경	미리 보기 1
RuntimeHelpers.GetSubArray가 다른 형식을 반환함	동작 변경	미리 보기 1

타이틀	변경 형식	도입된 버전
HttpListenerRequest.UserAgent가 null 허용임	원본이 호환되지 않음	미리 보기 1

타이틀	변경 형식	도입된 버전
`dotnet workload` 명령 출력 변경	동작 변경	미리 보기 1
터미널 로거가 기본값임	동작 변경	미리 보기 1

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

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