Iron Suite for .NET
10개의 .NET 라이브러리. 완전한 문서 슈트
.NET 11로 마이그레이션 중이신가요? 우선 이 중대한 변경 사항을 확인하세요
.NET 11이 다가오고 있으며, 호환성 변경 사항 목록이 이미 올라와 있습니다. 우리는 업그레이드 시 주의해야 할 사항을 알 수 있도록 한 줄씩 검토했습니다.
이는 좋은 소식이지만, 마이그레이션 테스트의 중요성도 커집니다.
많은 애플리케이션이 .NET 11로 리타겟팅한 후에도 여전히 깨끗하게 컴파일될 것입니다. 더 큰 위험은 동작의 변화입니다. 성공적으로 빌드되지만 새로운 예외를 던지거나 데이터를 다르게 처리하거나 런타임에 약간 다른 결과를 생성하는 코드입니다.
모든 호환성 항목을 하나씩 살펴보는 대신, 이 가이드는 실제 애플리케이션에 영향을 미칠 가능성이 높은 변경 사항과 프로덕션으로 이동하기 전에 테스트해야 할 사항에 중점을 둡니다.
전체 내용을 하나의 표로
| 변경 사항 | 발생하는 일 |
|---|---|
| ZIP 읽기 CRC32 검증 | 손상된 항목에서 InvalidDataException를 던짐 |
DateOnly/TimeOnly TryParse | 잘못된 형식이나 스타일에서 예외 발생 |
BackgroundService 실패 | 호스트가 시작/종료 시 예외 발생 |
| Math.Round 정확성 | 정확하게 반올림된 결과 반환 |
| 공유 프레임워크의 확장 | 어셈블리 버전 해상도가 변경될 수 있음 |
| 빌드 및 테스트 도구 | VSTest, NuGet, 템플릿 엔진 변경 |
우리가 먼저 확인할 것: ZIP 읽기가 이제 예외를 던짐
이는 문서 중심의 코드베이스에 가장 놀라운 변화일 수 있습니다. 조용히 있다가 갑자기 문제가 발생하기 때문입니다. .NET 11부터 System.IO.Compression은 ZIP 항목을 읽을 때 CRC32 체크섬을 검증하고, 저장된 체크섬이 데이터와 일치하지 않으면 InvalidDataException를 던집니다. 이전에는 손상되거나 변조된 항목이 아무 문제 없이 읽혔습니다.
이는 진정으로 좋은 변화입니다. 파일이 손상되었을 때 알기를 원하기 때문입니다. 그러나 사용자가 제공한 ZIP 파일이나 파트너, 오래된 저장소 버킷에서 가져온 ZIP 파일을 처리하는 앱이라면, 수년간 "작동했던" 코드가 예외를 던지기 시작할 수 있습니다. 해결책은 간단합니다. 읽기를 InvalidDataException로 감싸고 손상된 아카이브를 어떻게 처리할지 결정하십시오. 프로덕션에서 발견하기보다는 의도적으로 잡는 것이 낫습니다.
교묘한 변화: TryParse가 이제 예외를 던질 수 있음
모든 .NET 개발자는 TryParse가 절대 예외를 던지지 않고 bool을 반환한다는 것을 내재화했습니다. .NET 11에서는 DateOnly.TryParse, TimeOnly.TryParse 및 그 TryParseExact 형제들이 이 습관을 약간 깨뜨립니다. 잘못된 DateTimeStyles 값이나 잘못된 형식 지정자를 전달하면 조용히 false를 반환하는 대신 ArgumentException를 던집니다. 형식 문자열과 스타일이 하드코딩되어 있고 유효하다면 아무런 변화가 없습니다. 그러나 런타임에 계산되거나 사용자 입력에서 오는 경우, 이는 새로운 예외 경로를 커버해야 합니다.
그것이 당신의 세계인지 확인하십시오
나머지는 더 좁고, 그들이 사는 곳에 따라 그룹화되었습니다:
- ASP.NET Core. 몇 년 전부터 사용 중단된 Blazor API는 더 이상 컴파일되지 않습니다. Kestrel은 잘못된 HTTP 헤더에 대해 더 엄격합니다. 그리고 SQL 연결 문자열이 Entra ID (
Active Directory) 인증을 사용하는 경우, 이제Microsoft.Data.SqlClient.Extensions.Azure패키지가 필요하며, 이는 EF Core SQL Server 사용자에게도 해당됩니다. - 확장 및 호스팅. Worker 서비스는 더 크게 실패합니다:
BackgroundService가 예외를 던지면 호스트도 예외를 던지므로 시작 경로를 테스트하십시오. - 코어 라이브러리.
Math.Round와 복소수는 더 표준에 맞게 수정되었으며, 이는 테스트가 이전 값을 기대하는 경우에만 중요합니다. - 빌드 및 도구. VSTest는 Newtonsoft.Json을 제거하고, 템플릿 패키지는 netstandard2.0을 제거합니다. 이는 빌드 오류로 나타나므로 스스로를 알립니다.
- 플랫폼. 최소 CPU 요구 사항이 증가했고, .NET MAUI는 Android API 24가 필요하며, TLS 서버 측 인증서 가져오기는 기본적으로 꺼져 있습니다. 이러한 사항이 해당되는지 알 수 있습니다.
걱정할 필요가 없는 한 가지
.NET 11 준비를 위해 종속성을 감사하는 동안, 문서 도구는 목록에 포함되지 않아야 합니다. Iron Suite 라이브러리는 순수 관리 .NET이며 이미 .NET 11부터 .NET Framework까지 실행되므로 IronPDF, IronXL 및 나머지 제품군은 앱과 함께 이동하며 이를 차단하지 않습니다. 위의 ZIP 변경 사항이 이러한 라이브러리가 대체하는 파일 처리 코드 바로 옆에 위치해 있다는 점을 고려할 때, 수작업으로 문서나 아카이브 배관을 처리했다면, 마이그레이션은 이미 각 .NET 릴리스를 추적하는 라이브러리에 그 부분을 맡기는 자연스러운 순간입니다.
자체 페이지에 있는 ASP.NET Core 변경 사항을 포함한 전체 목록은 Microsoft .NET 11 breaking changes reference가 북마크할 소스입니다. 이 목록이 계속 채워지고 있으므로 목록이 증가함에 따라 이 게시물을 업데이트할 것입니다.