DEV Community

John Smith
John Smith

Posted on • Originally published at on

Migrate .NET Core 3.1 to .NET Core 5.0


The very latest version of .NET Core was launched at .NET Conf.

It is the free, cross-platform and open-source developer platform from Microsoft which includes the latest versions of ASP.NET and C# among others.

I decided to wait until the upgrade was available in all the various package managers such as homebrew on macOS and apt-get on Ubuntu and chocolatey on Windows before I upgraded my projects.

This ensured that my operating systems were upgraded from .NET Core 3.1 to .NET Core 5.0 for me almost automatically.

This post will hopefully document the steps needed to upgrade an ASP.NET Core 3.1 Razor Pages project from ASP.NET Core 3.1 to ASP.NET Core 5.0.

The migrate from .NET Core 3.1 to 5.0 document over at Microsoft should help you as it did me.

But for those that want to know what I had change here goes:

Getting Started 🌱

The main change will be to the Target Framework the website’s .csproj file however, in my case I had to change it in my Directory.Build.Props file which covers all of the projects in my solution.


- <TargetFramework>netcoreapp3.1</TargetFramework>
+ <TargetFramework>net5.0</TargetFramework>
Enter fullscreen mode Exit fullscreen mode

Next up I had to make a change to prevent a new build error that cropped up in an extension method of mine, something I am sure worked fine under .NET Core 3.1:


public static T GetHeaderValueAs<T>(this IHttpContextAccessor accessor, string headerName)
- StringValues values;
+ StringValues values = default;

    if (accessor.HttpContext?.Request?.Headers?.TryGetValue(headerName, out values) ?? false)
        var rawValues = values.ToString();
Enter fullscreen mode Exit fullscreen mode

Then I needed to make a change to ensure that Visual Studio Code (Insiders) would debug my project properly.


    "name": ".NET Core Launch (console)",
    "type": "coreclr",
    "request": "launch",
    "preLaunchTask": "build",
- "program": "${workspaceRoot}/src/projectname/bin/Debug/netcoreapp3.1/projectname.dll",
+ "program": "${workspaceRoot}/src/projectname/bin/Debug/net5.0/projectname.dll",
    "args": [],
    "cwd": "${workspaceFolder}",
    "stopAtEntry": false,
    "console": "externalTerminal"
Enter fullscreen mode Exit fullscreen mode

This particular project has the source code hosted at Bitbucket and my pipelines file needed the following change.

Bitbucket Pipelines is basically Atlassian’s version of Github Actions.


- image:
+ image:
        - step:
Enter fullscreen mode Exit fullscreen mode

A related change was that I needed to make a change to my Dockerfile so that it uses the latest .NET 5 SDK and runtime.


- FROM AS build
+ FROM AS build

- FROM AS runtime
+ FROM AS runtime
Enter fullscreen mode Exit fullscreen mode

I then ran a tool called dotnet outdated which upgraded all my NuGet packages including the Microsoft Framework packages going from 3.1 to 5.0.

For example:

dotnet outdated:

dotnet tool install --global dotnet-outdated-tool
dotnet outdated -u

» web
  AWSSDK.S3 -> 3.5.4
  Microsoft.AspNetCore.Mvc.NewtonsoftJson 3.1.9 -> 5.0.0
  Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation 3.1.9 -> 5.0.0
  Microsoft.EntityFrameworkCore.Design 3.1.9 -> 5.0.0
  Microsoft.Extensions.Configuration.UserSecrets 3.1.9 -> 5.0.0
  Microsoft.VisualStudio.Web.CodeGeneration.Design 3.1.4 -> 5.0.0
  Microsoft.Web.LibraryManager.Build 2.1.76 -> 2.1.113
Enter fullscreen mode Exit fullscreen mode

This changed my website’s csproj file to use the correct nuget packages for .NET 5.

A much quicker way than doing it manually.


- <PackageReference Include="Microsoft.AspNetCore.Mvc.NewtonsoftJson" Version="3.1.9" />
+ <PackageReference Include="Microsoft.AspNetCore.Mvc.NewtonsoftJson" Version="5.0.0" />
Enter fullscreen mode Exit fullscreen mode

Deployments 🚀

And finally, one thing I forgot once I tried to deploy was that in my project, I use Visual Studio Publish Profiles to automatically deploy the site via MsBuild and I needed to change the Target Framework and Publish Framework versions before it would deploy correctly.


- <PublishFramework>netcoreapp3.1</PublishFramework>
+ <PublishFramework>net5.0</PublishFramework>
- <TargetFramework>netcoreapp3.1</TargetFramework>
+ <TargetFramework>net5.0</TargetFramework>
Enter fullscreen mode Exit fullscreen mode

And with that I was done. A fairly large and complex application was ported over.

By all accounts .NET 5 has performance and allocation improvements all across the board so I am looking forward to seeing the results of all that hard work.

Success 🥳

Top comments (0)