Udostępnij za pośrednictwem

Istotne zmiany na platformie .NET 9

  • Artykuł

Jeśli migrujesz aplikację do platformy .NET 9, 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 niezgodną binarną lub niezgodną źródłową albo jako zmianę behawioralną:

  • Niezgodne dane binarne — w przypadku uruchamiania względem nowego środowiska uruchomieniowego lub składnika istniejące pliki binarne mogą napotkać niezgodną zmianę zachowania, taką jak niepowodzenie ładowania lub wykonywania, a jeśli tak, wymagaj ponownej kompilacji.

  • Niezgodne źródło — w przypadku ponownego skompilowania przy użyciu nowego zestawu SDK lub składnika lub docelowego nowego środowiska uruchomieniowego istniejący kod źródłowy może wymagać pomyślnego skompilowania zmian źródłowych.

  • 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.

Uwaga

Ten artykuł jest w toku. Nie jest to pełna lista zmian powodujących niezgodność na platformie .NET 9. Aby wykonywać zapytania dotyczące zmian powodujących niezgodność, które nadal oczekują na publikację, zobacz Problemy z platformą .NET.

ASP.NET Core

Tytuł Typ zmiany Wprowadzona wersja
DefaultKeyResolution.ShouldGenerateNewKey zmienił znaczenie Zmiana zachowania Wersja zapoznawcza 3

Podstawowe biblioteki platformy .NET

Tytuł Typ zmiany Wprowadzona wersja
Dodawanie pliku ZipArchiveEntry z funkcją CompressionLevel ustawia flagi bitów ogólnego przeznaczenia nagłówka katalogu ZIP Zmiana zachowania Wersja zapoznawcza 5
Obsoletions interfejsu API z niestandardowymi identyfikatorami diagnostycznymi Niezgodne źródło Wersja zapoznawcza 1
Tworzenie typu tablicy system.Void jest niedozwolone Zmiana zachowania Wersja zapoznawcza 1
Wymuszono limit rozmiaru struktury tablicy wbudowanej Zmiana zachowania Wersja zapoznawcza 1
InMemoryDirectoryInfo prepends rootDir do plików Zmiana zachowania Wersja zapoznawcza 1
RuntimeHelpers.GetSubArray zwraca inny typ Zmiana zachowania Wersja zapoznawcza 1

Sieć

Tytuł Typ zmiany Wprowadzona wersja
Element HttpListenerRequest.UserAgent ma wartość null Niezgodne źródło Wersja zapoznawcza 1

Zestaw SDK i program MSBuild

Tytuł Typ zmiany Wprowadzona wersja
dotnet workload zmiany danych wyjściowych poleceń Zmiana zachowania Wersja zapoznawcza 1
Rejestrator terminalu jest domyślny Zmiana zachowania Wersja zapoznawcza 1

Windows Forms

Tytuł Typ zmiany Wprowadzona wersja
BindingSource.SortDescriptions nie zwraca wartości null Zmiana zachowania Wersja zapoznawcza 1
Zmiany adnotacji o wartości null Niezgodne źródło Wersja zapoznawcza 1
SkładnikDesigner.Initialize zgłasza wyjątek ArgumentNullException Zmiana zachowania Wersja zapoznawcza 1
DataGridViewRowAccessibleObject.Name początkowy indeks wiersza Zmiana zachowania Wersja zapoznawcza 1
Brak wyjątku, jeśli kontrolka DataGridView ma wartość null Zmiana zachowania Wersja zapoznawcza 1

WPF

Tytuł Typ zmiany Wprowadzona wersja
GetXmlNamespaceMaps zmiana typu Zmiana zachowania/Niezgodność źródła Wersja zapoznawcza 3

Zobacz też