Критические изменения в .NET 9

Если вы переносите приложение на .NET 9, критические изменения, перечисленные здесь, могут повлиять на вас. Изменения сгруппированы по технологическим областям, например, ASP.NET Core или Windows Forms.

Эта статья классифицирует каждое критическое изменение как несовместимое двоичное или исходное несовместимое или как изменение поведения:

  • Несовместимый двоичный файл . При запуске в новой среде выполнения или компонента существующие двоичные файлы могут столкнуться с критическим изменением в поведении, например сбоем загрузки или выполнения, а если да, требовать повторной компиляции.

  • Несовместимый источник. При повторной компиляции с помощью нового пакета SDK или компонента или целевой среды выполнения существующий исходный код может требовать изменения источника для успешной компиляции.

  • Изменение поведения. Существующий код и двоичные файлы могут вести себя по-разному во время выполнения. Если новое поведение нежелательно, необходимо обновить и перекомпилировать существующий код.

Примечание.

Эта статья выполняется. Это не полный список критических изменений в .NET 9. Сведения о критических изменениях, которые все еще ожидают публикации, см. в разделе Проблемы .NET.

ASP.NET Core

Заголовок Тип изменения Представленные версии
DefaultKeyResolution.ShouldGenerateNewKey изменил значение изменение поведения; 3 (предварительная версия)

Основные библиотеки .NET

Заголовок Тип изменения Представленные версии
Обзоление API с пользовательскими идентификаторами диагностики Несовместимый источник Предварительная версия 1
Создание типа массива System.Void запрещено изменение поведения; Предварительная версия 1
Ограничение размера структуры встроенного массива применяется изменение поведения; Предварительная версия 1
InMemoryDirectoryInfo prepends rootDir to files изменение поведения; Предварительная версия 1
RuntimeHelpers.GetSubArray возвращает другой тип изменение поведения; Предварительная версия 1

Сеть

Заголовок Тип изменения Представленные версии
HttpListenerRequest.UserAgent имеет значение NULL Несовместимый источник Предварительная версия 1

SDK и MSBuild

Заголовок Тип изменения Представленные версии
dotnet workload Изменение выходных данных команд изменение поведения; Предварительная версия 1
Средство ведения журнала терминалов по умолчанию изменение поведения; Предварительная версия 1

Windows Forms

Заголовок Тип изменения Представленные версии
BindingSource.SortDescriptions не возвращает значение NULL изменение поведения; Предварительная версия 1
Изменения примечаний null Несовместимый источник Предварительная версия 1
ComponentDesigner.Initialize создает исключение ArgumentNullException изменение поведения; Предварительная версия 1
DataGridViewRowAccessibleObject.Name начальный индекс строки изменение поведения; Предварительная версия 1
Исключение, если DataGridView имеет значение NULL изменение поведения; Предварительная версия 1

WPF

Заголовок Тип изменения Представленные версии
GetXmlNamespaceMaps Изменение типа Изменение поведения или несовместимое источник 3 (предварительная версия)

См. также