Iron Suite for .NET

10 bibliotek .NET. Jedna kompletna suite dokumentów.

WIADOMOŚCI Z BRANŻY

Migracja do .NET 11? Najpierw sprawdź te zmiany naruszajace zgodnosc wstecz.

Curtis Chau
Curtis Chau
Zaktualizowano: 31 sierpnia 2026

.NET 11 jest blisko, a lista zmian łamiących jest już dostępna. Przeszliśmy przez nią linia po linii, abyś mógł przystąpić do aktualizacji wiedząc, na co zwrócić uwagę.

To dobra wiadomość, ale również sprawia, że testowanie migracji jest bardziej istotne.

Wiele aplikacji nadal będzie się kompilować bez błędów po przestawieniu na .NET 11. Większym ryzykiem jest zmiana zachowania: kod, który buduje się pomyślnie, ale rzuca nowy wyjątek, inaczej obsługuje dane lub daje nieco inne wyniki w czasie działania.

Zamiast przechodzić przez każdy element kompatybilności jeden po drugim, ten przewodnik koncentruje się na zmianach, które najprawdopodobniej wpłyną na rzeczywiste aplikacje i co powinieneś przetestować przed przejściem do produkcji.

Całość w jednej tabeli

ZmianaCo się dzieje
Odczyt ZIP weryfikuje CRC32Rzuca InvalidDataException na uszkodzonych wpisach
DateOnly/TimeOnly TryParseRzuca na nieprawidłowy format lub styl
BackgroundService niepowodzenieHost rzuca przy uruchomieniu/zamknięciu
Poprawność Math.RoundZwraca poprawnie zaokrąglone wyniki
Rozszerzenia w wspólnej ramceRozwiązanie wersji zestawu może się zmienić
Narzędzia do budowy i testowaniaZmiany w VSTest, NuGet, template-engine

Pierwsza rzecz do sprawdzenia: odczyt ZIP teraz rzuca

To zmiana, która najprawdopodobniej zaskoczy bazę kodu z dużą ilością dokumentów, ponieważ jest cicha, dopóki nie jest. Począwszy od .NET 11, System.IO.Compression weryfikuje sumę kontrolną CRC32 podczas odczytu wpisu ZIP i rzuca InvalidDataException, jeśli przechowywana suma kontrolna nie pasuje do danych. Wcześniej uszkodzony lub zmanipulowany wpis był odczytywany bez żadnych skarg.

To naprawdę dobra zmiana, chcesz wiedzieć, kiedy plik jest zły, ale jeśli twoja aplikacja przyjmuje pliki ZIP od użytkowników, partnerów lub ze starego magazynu, kod, który "działał" przez lata, może zacząć rzucać wyjątki. Naprawa jest niewielka: owiń swój odczyt w try-catch dla InvalidDataException i zdecyduj, jak chcesz obsłużyć zły archiwum. Lepiej złapać to celowo niż odkryć w produkcji.

Podstępna zmiana: TryParse może teraz rzucać

Każdy deweloper .NET przyswoił sobie, że TryParse nigdy nie rzuca, zwraca bool. W .NET 11, DateOnly.TryParse, TimeOnly.TryParse i ich TryParseExact rodzeństwo łamią ten nawyk nieco: przekaż nieprawidłową wartość DateTimeStyles lub zły specyfikator formatu, a teraz rzucają ArgumentException zamiast cicho zwracać false. Jeśli twoje ciągi formatu i style są zakodowane na stałe i prawidłowe, nic się nie zmienia. Jeśli są obliczane w czasie działania lub pochodzą od użytkownika, to nowa ścieżka wyjątków do pokrycia.

Sprawdź tylko, jeśli to twój świat

Reszta jest węższa i pogrupowana według miejsca, w którym się znajdują:

  • ASP.NET Core. Stare API Blazor oznaczone jako przestarzałe lata temu nie kompilują się już. Kestrel jest bardziej rygorystyczny w kwestii nieprawidłowych nagłówków HTTP. A jeśli twój ciąg połączenia SQL używa Entra ID (Active Directory) auth, teraz potrzebujesz pakietu Microsoft.Data.SqlClient.Extensions.Azure, to również dotyczy użytkowników EF Core SQL Server.
  • Rozszerzenia i hosting. Usługi pracownicze zawodzą głośniej: jeśli BackgroundService rzuca, host również rzuca, więc przetestuj swoją ścieżkę uruchamiania.
  • Biblioteki podstawowe. Math.Round i liczby zespolone stały się bardziej zgodne ze standardami, co ma znaczenie tylko wtedy, gdy testy oczekują starych wartości.
  • Budowa i narzędzia. VSTest usuwa Newtonsoft.Json, pakiety szablonów usuwają netstandard2.0. Te pojawiają się jako błędy budowy, więc same się ogłaszają.
  • Platforma. Minimalne wymagania dotyczące CPU wzrosły, .NET MAUI potrzebuje Android API 24, a pobieranie certyfikatów TLS po stronie serwera jest domyślnie wyłączone. Będziesz wiedział, jeśli to dotyczy ciebie.

Jedna rzecz, o którą nie musisz się martwić

Podczas audytu zależności pod kątem gotowości do .NET 11, twoje narzędzia do dokumentów nie powinny być na liście. Biblioteki Iron Suite są czystym zarządzanym .NET i już działają na .NET 11 przez .NET Framework, więc IronPDF, IronXL i reszta pakietu poruszają się z twoją aplikacją zamiast ją blokować. Warto zauważyć, biorąc pod uwagę, że zmiana ZIP powyżej znajduje się tuż obok rodzaju kodu obsługi plików, który te biblioteki zastępują, jeśli masz ręcznie napisane dokumenty lub archiwalne rurociągi, migracja jest naturalnym momentem, aby przekazać tę część bibliotece, która już śledzi każdą wersję .NET.

Dla pełnej listy, w tym zmian ASP.NET Core, które znajdują się na własnej stronie, referencja zmian łamiących Microsoft .NET 11 jest źródłem do zakładki. Będziemy aktualizować ten post, gdy lista się powiększy, ponieważ nadal się wypełnia.