Breaking changes in .NET

Use this reference section to find breaking changes that might apply to you if you're upgrading your app to a newer version of .NET. You can navigate the table of contents either by .NET version or by technology area.

If you're looking for breaking changes from .NET Framework to .NET, see Breaking changes for migration from .NET Framework to .NET (Core).

GitHub issues and announcements

You can also view individual issues that detail the breaking changes introduced in .NET in the following GitHub repositories:

• For .NET Core and .NET 5+, the dotnet/docs repository.
• For ASP.NET Core, the aspnet/Announcements repository.
• For Entity Framework Core, the dotnet/efcore repository.

See also

• API removal in .NET
• .NET runtime compatibility
• Migrate from .NET Framework to .NET Core
• Breaking changes for migration from .NET Framework to .NET Core