Zmiany powodujące niezgodność na platformie .NET 7

Jeśli migrujesz aplikację do platformy .NET 7, zmiany powodujące niezgodność wymienione tutaj mogą mieć wpływ na Ciebie. Zmiany są pogrupowane według obszaru technologii, takiego jak ASP.NET Core lub Windows Forms.

Ten artykuł kategoryzuje każdą zmianę powodującą niezgodność jako niezgodność binarną lub niezgodność źródła , lub jako zmianę zachowania .

  • Niekompatybilne binaria — w przypadku uruchamiania w nowym środowisku uruchomieniowym lub w stosunku do nowego składnika, istniejące pliki binarne mogą napotkać istotną zmianę w działaniu, taką jak niepowodzenie ładowania lub uruchomienia, i w takim przypadku wymagają ponownej kompilacji.

  • Niekompatybilne źródło — W przypadku ponownego skompilowania przy użyciu nowego zestawu SDK lub składnika albo w celu skierowania na nowe środowisko uruchomieniowe, istniejący kod źródłowy może wymagać wprowadzenia zmian, aby można go było pomyślnie skompilować.

  • Zmiana zachowania — istniejący kod i pliki binarne mogą zachowywać się inaczej w czasie wykonywania. Jeśli nowe zachowanie jest niepożądane, należy zaktualizować i ponownie skompilować istniejący kod.

ASP.NET Core

Zobacz Zmiany powodujące niezgodność w ASP.NET Core 7.

Podstawowe biblioteki platformy .NET

Tytuł Typ zmiany
Obsesje interfejsu API z domyślnym identyfikatorem diagnostycznym Niezgodne źródło
Obsoletions interfejsu API z nie domyślnymi identyfikatorami diagnostycznymi Niezgodne źródło
gwiazdka nie jest już akceptowana dla atrybutów nazwy zestawu Zmiana zachowania
Interfejsy API serializacji BinaryFormatter generują błędy kompilatora Niezgodne źródło
Funkcja BrotliStream nie zezwala już na niezdefiniowane wartości CompressionLevel Binarna niezgodność
Projekty języka C++/interfejsu wiersza polecenia w programie Visual Studio Niezgodne źródło
Zmiany w odbiciu wywołują wyjątki interfejsu API Binarna niezgodność
Zestaw zbieralny w obiekcie AssemblyLoadContext, który nie jest zbieralny Binarna niezgodność
Zmiana dokładności metod dodawania daty/godziny Zmiana zachowania
Zmiana zachowania metody równości dla sieci NaN Binarna niezgodność
Zachowanie wywołania zwrotnego źródła zdarzeń Zmiana zachowania
Ograniczenie typu ogólnego w obiekcie PatternContext<T> Niezgodne dane binarne/źródło
Usunięto starszą strategię FileStream Binarna niezgodność
Obsługa bibliotek dla starszych platform Niezgodne dane binarne/źródło
Maksymalna precyzja ciągów formatu liczbowego Binarna niezgodność
Wzorce wyrażeń regularnych z poprawionymi zakresami Zmiana zachowania
SerializationFormat.Binary jest przestarzały Niezgodne dane binarne/źródło
Usunięto przełącznik konfiguracji System.Drawing.Common Zmiana zachowania
System.Runtime.CompilerServices.Niebezpieczny pakiet NuGet Zmiana zachowania
Pola czasu w linkach symbolicznych Binarna niezgodność
Śledzenie wpisów połączonej pamięci podręcznej Binarna niezgodność
Validate CompressionLevel for BrotliStream Binarna niezgodność

Konfigurowanie

Tytuł Typ zmiany
Wpis System.diagnostics w pliku app.config Binarna niezgodność

Kryptografia

Tytuł Typ zmiany
Odszyfrowywanie kopertyCms nie powoduje podwójnego odpakowywania Binarna niezgodność
Dynamiczny czas weryfikacji X509ChainPolicy Binarna niezgodność
X500DistinguishedName analizowanie przyjaznych nazw Binarna niezgodność

Wdrożenie

Tytuł Typ zmiany
Wszystkie zestawy domyślnie przycinane Niezgodne źródło
Wyszukiwanie wielowymiarowe jest wyłączone Binarna niezgodność
Ścieżka hosta x86 w 64-bitowym systemie Windows Zmiana zachowania
Funkcja TrimmerDefaultAction jest przestarzała Niezgodne źródło

Entity Framework Core

Zobacz Istotne zmiany w EF Core 7.

Rozszerzenia

Tytuł Typ zmiany
Konfiguracja powiązania ze słownika rozszerza wartości Zmiana zachowania
ContentRootPath dla aplikacji uruchomionych przez powłokę systemu Windows Binarna niezgodność
Prefiksy zmiennych środowiskowych Binarna niezgodność

Globalizacja

Tytuł Typ zmiany
Interfejsy API globalizacji używają bibliotek ICU w systemie Windows Server Binarna niezgodność

Interoperacyjność

Tytuł Typ zmiany
RuntimeInformation.OSArchitecture w ramach emulacji Binarna niezgodność

.NET MAUI

Tytuł Typ zmiany
Konstruktory akceptują interfejs podstawowy zamiast konkretnego typu Binarna niezgodność
Metody pomocnika kierunku przepływu usunięte Niezgodne dane binarne/źródło
Nowy parametr UpdateBackground Binarna niezgodność
Zmieniono nazwę właściwości ScrollToRequest Niezgodne dane binarne/źródło
Niektóre interfejsy API systemu Windows są usuwane Niezgodne dane binarne/źródło

Sieć

Tytuł Typ zmiany
Wartość domyślna AllowRenegotiation to false Niezgodne dane binarne/źródło
Niestandardowe ładunki ping w systemie Linux Binarna niezgodność
Metody Socket.End nie zgłaszają wyjątku ObjectDisposedException Binarna niezgodność

Zestaw SDK i program MSBuild

Tytuł Typ zmiany
Automatyczne środowisko uruchomienioweIdentifier tylko do publikowania Niezgodne dane binarne/źródło
Dane wyjściowe konsoli interfejsu wiersza polecenia używają protokołu UTF-8 Niezgodne dane binarne/źródło
Kodowanie konsoli nie UTF-8 po zakończeniu Binarna niezgodność
Serializacja MSBuild typów niestandardowych na platformie .NET 7 Niezgodne dane binarne/źródło
Instalacje równoległych zestawów SDK Niezgodne dane binarne/źródło
Manifesty narzędzi w folderze głównym Zmiana zachowania
Wymagania dotyczące wersji zestawu .NET 7 SDK Zmiana zachowania
dotnet test: przełącz -a się do aliasu --arch zamiast --test-adapter-path Niezgodne dane binarne/źródło
dotnet test: przełącz -r się do aliasu --runtime zamiast --results-dir Niezgodne dane binarne/źródło
--output opcja nie jest już prawidłowa dla poleceń na poziomie rozwiązania Niezgodne dane binarne/źródło
Zestaw SDK nie wywołuje już funkcji ResolvePackageDependencies Niezgodne źródło

Serializacja

Tytuł Typ zmiany
DataContractSerializer zachowuje znak podczas deserializacji -0 Binarna niezgodność
Deserializowanie typu wersji z wiodącym lub końcowym białym znakiem Binarna niezgodność
Konstruktor kopiowania JsonSerializerOptions zawiera konstruktor JsonSerializerContext Binarna niezgodność
Serializacja polimorficzna dla typów obiektów Binarna niezgodność
Rezerwa generatora źródła System.Text.Json Binarna niezgodność

Windows Forms

Tytuł Typ zmiany
Obsoletions i ostrzeżenia Niezgodne źródło
Niektóre interfejsy API zgłaszają wyjątek ArgumentNullException Binarna niezgodność

WPF

Tytuł Typ zmiany
Przywrócone zachowanie operacji przeciągania i upuszczania w edytorach tekstu Zmiana zachowania

XML i XSLT

Tytuł Typ zmiany
Element XmlSecureResolver jest przestarzały Niezgodne dane binarne/źródło

Zobacz też