Skip to content

🚀 Upgrade ContosoUniversity from .NET Framework 4.8 to .NET 8.0 #5

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
barea1 wants to merge 16 commits into
base: main
Choose a base branch
from
Open

🚀 Upgrade ContosoUniversity from .NET Framework 4.8 to .NET 8.0 #5

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
16 commits
Select commit Hold shift + click to select a range
644166b
Inicio de la rama Refactor-uno
Oct 30, 2025
44f6cd9
Fix: Remove empty TargetFrameworkProfile property to resolve NuGet bu…
Nov 3, 2025
03c4c08
Archivos iniciales para migración en Refactor-tres
Nov 3, 2025
ff227f8
Commit upgrade plan
Nov 3, 2025
8151f66
Migrate project to ASP.NET Core; remove legacy files
Nov 3, 2025
2794b12
Update ContosoUniversity.csproj dependencies to latest versions
Nov 3, 2025
d631c43
Update SqlClient.SNI.runtime version in csproj file
Nov 3, 2025
1523713
Migrate project from ASP.NET MVC to ASP.NET Core
Nov 3, 2025
dfe4fc4
System.Web.Optimization bundling and minification feature upgrade com…
Nov 3, 2025
716ebc8
RouteCollection feature upgrade completed: default MVC route mapping …
Nov 3, 2025
2ffe59e
Commit changes before fixing errors.
Nov 3, 2025
6948041
* 'Línea 164: Replaced 'Server.MapPath' with 'System.Web.HttpContext.…
Nov 3, 2025
4da6999
* 'Línea 2: Removed the using directive for MSMQ.Messaging because th…
Nov 3, 2025
cdab836
* 'Línea 11: MessageQueue type is not available in .NET 8.0 and Syste…
Nov 3, 2025
e76191c
* 'Línea 11: Updated the comment to clarify that MessageQueue is not …
Nov 3, 2025
9cbf7bb
✅ Complete .NET 8.0 upgrade with Azure deployment configuration
Nov 3, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
116 changes: 116 additions & 0 deletions .github/upgrades/dotnet-upgrade-plan.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,116 @@
# .NET 8.0 Upgrade Plan

## Execution Steps

Execute steps below sequentially one by one in the order they are listed.

1. Validate that a .NET 8.0 SDK required for this upgrade is installed on the machine and if not, help to get it installed.
2. Ensure that the SDK version specified in global.json files is compatible with the .NET 8.0 upgrade.
3. Upgrade ContosoUniversity.csproj

## Settings

This section contains settings and data used by execution steps.

### Aggregate NuGet packages modifications across all projects

NuGet packages used across all selected projects or their dependencies that need version update in projects that reference them.

| Package Name | Current Version | New Version | Description |
|:----------------------------------------------------|:---------------:|:-----------:|:-------------------------------------------------------------------------|
| Antlr | 3.4.1.9004 | | Replace with Antlr4 4.6.6 |
| Antlr4 | | 4.6.6 | Replacement for Antlr |
| Microsoft.AspNet.Mvc | 5.2.9 | | Functionality included with the new framework reference |
| Microsoft.AspNet.Razor | 3.2.9 | | Functionality included with the new framework reference |
| Microsoft.AspNet.Web.Optimization | 1.1.3 | | Not compatible - no replacement available |
| Microsoft.AspNet.WebPages | 3.2.9 | | Functionality included with the new framework reference |
| Microsoft.Bcl.AsyncInterfaces | 1.1.1 | 8.0.0 | Recommended for .NET 8.0 |
| Microsoft.Bcl.HashCode | 1.1.1 | 6.0.0 | Recommended for .NET 8.0|
| Microsoft.CodeDom.Providers.DotNetCompilerPlatform | 2.0.1 | | Functionality included with the new framework reference |
| Microsoft.Data.SqlClient | 2.1.4 | 6.1.2| Security vulnerability (CVE-2024-0056) |
| Microsoft.EntityFrameworkCore | 3.1.32 | 8.0.21 | Recommended for .NET 8.0 |
| Microsoft.EntityFrameworkCore.Abstractions | 3.1.32 | 8.0.21 | Recommended for .NET 8.0 |
| Microsoft.EntityFrameworkCore.Analyzers | 3.1.32 | 8.0.21 | Recommended for .NET 8.0 |
| Microsoft.EntityFrameworkCore.Relational | 3.1.32 | 8.0.21 | Recommended for .NET 8.0 |
| Microsoft.EntityFrameworkCore.SqlServer | 3.1.32 | 8.0.21 | Recommended for .NET 8.0 |
| Microsoft.EntityFrameworkCore.Tools | 3.1.32 | 8.0.21 | Recommended for .NET 8.0 |
| Microsoft.Extensions.Caching.Abstractions | 3.1.32 | 8.0.0 | Recommended for .NET 8.0 |
| Microsoft.Extensions.Caching.Memory | 3.1.32 | 8.0.1 | Recommended for .NET 8.0 |
| Microsoft.Extensions.Configuration | 3.1.32 | 8.0.0 | Recommended for .NET 8.0 |
| Microsoft.Extensions.Configuration.Abstractions | 3.1.32 | 8.0.0 | Recommended for .NET 8.0 |
| Microsoft.Extensions.Configuration.Binder | 3.1.32 | 8.0.2 | Recommended for .NET 8.0 |
| Microsoft.Extensions.DependencyInjection | 3.1.32 | 8.0.1 | Recommended for .NET 8.0 |
| Microsoft.Extensions.DependencyInjection.Abstractions | 3.1.32 | 8.0.2 | Recommended for .NET 8.0 |
| Microsoft.Extensions.Logging | 3.1.32 | 8.0.1 | Recommended for .NET 8.0 |
| Microsoft.Extensions.Logging.Abstractions | 3.1.32 | 8.0.3 | Recommended for .NET 8.0 |
| Microsoft.Extensions.Options | 3.1.32 | 8.0.2 | Recommended for .NET 8.0 |
| Microsoft.Extensions.Primitives | 3.1.32 | 8.0.0 | Recommended for .NET 8.0 |
| Microsoft.Identity.Client | 4.21.1 | 4.78.0 | Security - deprecated version |
| Microsoft.Web.Infrastructure | 2.0.1 | | Functionality included with the new framework reference |
| NETStandard.Library | 2.0.3 | | Functionality included with the new framework reference |
| Newtonsoft.Json| 13.0.3 | 13.0.4 | Recommended for .NET 8.0 |
| System.Buffers | 4.5.1 | | Functionality included with the new framework reference |
| System.Collections.Immutable | 1.7.1| 8.0.0 | Recommended for .NET 8.0 |
| System.ComponentModel.Annotations | 4.7.0 | | Functionality included with the new framework reference |
| System.Diagnostics.DiagnosticSource | 4.7.1 | 8.0.1 | Recommended for .NET 8.0 |
| System.Memory | 4.5.4 | | Functionality included with the new framework reference |
| System.Numerics.Vectors | 4.5.0 | | Functionality included with the new framework reference |
| System.Runtime.CompilerServices.Unsafe | 4.5.3 | 6.1.2 | Recommended for .NET 8.0 |
| System.Threading.Tasks.Extensions | 4.5.4 | | Functionality included with the new framework reference |

### Project upgrade details

This section contains details about each project upgrade and modifications that need to be done in the project.

#### ContosoUniversity.csproj modifications

Project properties changes:
- Project must be converted to SDK-style project format
- Target framework should be changed from `net48` to `net8.0`

NuGet packages changes:
- Antlr should be replaced with Antlr4 4.6.6
- Microsoft.AspNet.Mvc should be removed (*functionality included with framework*)
- Microsoft.AspNet.Razor should be removed (*functionality included with framework*)
- Microsoft.AspNet.Web.Optimization should be removed (*not compatible*)
- Microsoft.AspNet.WebPages should be removed (*functionality included with framework*)
- Microsoft.Bcl.AsyncInterfaces should be updated from `1.1.1` to `8.0.0` (*recommended for .NET 8.0*)
- Microsoft.Bcl.HashCode should be updated from `1.1.1` to `6.0.0` (*recommended for .NET 8.0*)
- Microsoft.CodeDom.Providers.DotNetCompilerPlatform should be removed (*functionality included with framework*)
- Microsoft.Data.SqlClient should be updated from `2.1.4` to `6.1.2` (*security vulnerability CVE-2024-0056*)
- Microsoft.EntityFrameworkCore should be updated from `3.1.32` to `8.0.21` (*recommended for .NET 8.0*)
- Microsoft.EntityFrameworkCore.Abstractions should be updated from `3.1.32` to `8.0.21` (*recommended for .NET 8.0*)
- Microsoft.EntityFrameworkCore.Analyzers should be updated from `3.1.32` to `8.0.21` (*recommended for .NET 8.0*)
- Microsoft.EntityFrameworkCore.Relational should be updated from `3.1.32` to `8.0.21` (*recommended for .NET 8.0*)
- Microsoft.EntityFrameworkCore.SqlServer should be updated from `3.1.32` to `8.0.21` (*recommended for .NET 8.0*)
- Microsoft.EntityFrameworkCore.Tools should be updated from `3.1.32` to `8.0.21` (*recommended for .NET 8.0*)
- Microsoft.Extensions.Caching.Abstractions should be updated from `3.1.32` to `8.0.0` (*recommended for .NET 8.0*)
- Microsoft.Extensions.Caching.Memory should be updated from `3.1.32` to `8.0.1` (*recommended for .NET 8.0*)
- Microsoft.Extensions.Configuration should be updated from `3.1.32` to `8.0.0` (*recommended for .NET 8.0*)
- Microsoft.Extensions.Configuration.Abstractions should be updated from `3.1.32` to `8.0.0` (*recommended for .NET 8.0*)
- Microsoft.Extensions.Configuration.Binder should be updated from `3.1.32` to `8.0.2` (*recommended for .NET 8.0*)
- Microsoft.Extensions.DependencyInjection should be updated from `3.1.32` to `8.0.1` (*recommended for .NET 8.0*)
- Microsoft.Extensions.DependencyInjection.Abstractions should be updated from `3.1.32` to `8.0.2` (*recommended for .NET 8.0*)
- Microsoft.Extensions.Logging should be updated from `3.1.32` to `8.0.1` (*recommended for .NET 8.0*)
- Microsoft.Extensions.Logging.Abstractions should be updated from `3.1.32` to `8.0.3` (*recommended for .NET 8.0*)
- Microsoft.Extensions.Options should be updated from `3.1.32` to `8.0.2` (*recommended for .NET 8.0*)
- Microsoft.Extensions.Primitives should be updated from `3.1.32` to `8.0.0` (*recommended for .NET 8.0*)
- Microsoft.Identity.Client should be updated from `4.21.1` to `4.78.0` (*security - deprecated version*)
- Microsoft.Web.Infrastructure should be removed (*functionality included with framework*)
- NETStandard.Library should be removed (*functionality included with framework*)
- Newtonsoft.Json should be updated from `13.0.3` to `13.0.4` (*recommended for .NET 8.0*)
- System.Buffers should be removed (*functionality included with framework*)
- System.Collections.Immutable should be updated from `1.7.1` to `8.0.0` (*recommended for .NET 8.0*)
- System.ComponentModel.Annotations should be removed (*functionality included with framework*)
- System.Diagnostics.DiagnosticSource should be updated from `4.7.1` to `8.0.1` (*recommended for .NET 8.0*)
- System.Memory should be removed (*functionality included with framework*)
- System.Numerics.Vectors should be removed (*functionality included with framework*)
- System.Runtime.CompilerServices.Unsafe should be updated from `4.5.3` to `6.1.2` (*recommended for .NET 8.0*)
- System.Threading.Tasks.Extensions should be removed (*functionality included with framework*)

Feature upgrades:
- System.Web.Optimization bundling and minification is not supported in .NET Core and should be replaced with actual html tags pointing to content files
- Routes registration via RouteCollection is not supported in .NET Core and needs to be converted to the route mappings on the application object
- GlobalFilterCollection is not supported in .NET Core and needs to be converted to the corresponding middleware registrations on the application object
- Convert System.Messaging to MSMQ in .NET Core
- Convert application initialization code from Global.asax.cs to .NET Core and clean up Global.asax.cs
Loading