U4-9314 - Update to Latest .Net Framework

Created by Shannon Deminick 22 Dec 2016, 23:10:06 Updated by Shannon Deminick 13 Sep 2018, 04:29:10

Subtask of: U4-7594

We will update Umbraco to be built against .Net 4.6.2

.Net 4.6 is now 2 years old and we are running on .Net 4.5.0 which is several years old now. There are various enhancements in which people can take advantage of in .Net builds > 4.5.0, here is a list of the updates that would benefit Umbraco and hosting providers:

  • Better Azure SQL retry policies
  • Better Cryptography support
  • More enhanced profiling/debugging support
  • Better Async support
  • Better SQL Server support + always on encryption support
  • Better Globalization support with up-to-date Unicode standards
  • Garbage Collector enhancements
  • ASP.Net enhancements


We will need to have a look at our retry policies for SQL Azure since they might be deprecated since this is built into .Net 4.6.2: https://msdn.microsoft.com/en-us/library/ms171868(v=vs.110).aspx#Introducing the .NET Framework 4.6.2

Compatibility guide: https://msdn.microsoft.com/en-us/library/ff657133(v=vs.110).aspx

(pretty sure we've already upgraded the v8 branch and it works just fine)


Shannon Deminick 06 Feb 2017, 23:33:04

Marking as a 'breaking change' only because it's a new server requirement

Shannon Deminick 06 Feb 2017, 23:33:39

I'll update this too: https://our.umbraco.org/documentation/Getting-Started/Setup/Requirements/

Shannon Deminick 07 Feb 2017, 00:23:10

PR is here: https://github.com/umbraco/Umbraco-CMS/pull/1738

  • Had to update to latest semver, even though that is a major version change there are no breaking changes, it's a major version change because it now also supports dotnetcore
  • Updated nuspec to have correct framework folders for dlls (i.e. lib/net462 )

I've tested installing Articulate = works and Local Gov = works

For testing:

  • Make sure it builds
  • Make sure the build.bat builds
  • Use the output of the build and test on IIS and IIS Express
  • Install your favorite packages and make sure they work

Warren Buckley 07 Feb 2017, 17:34:54

I can confirm that it builds - after VS Prompted to go & download .NET Framework 4.6.2 as required A build bat built all the artifacts without any problems and using the regular Zip output with IISExpress & Full IIS works fine as the Fanoe SK installed correctly and general click through of backoffice & frontend site shows all OK.

Fixed up merge conflict for pulling this back in. Marked as fixed.

Priority: Normal

Type: Bug

State: Fixed


Difficulty: Normal


Backwards Compatible: False

Fix Submitted:

Affected versions:

Due in version: 8.0.0


Story Points: 0.5