Introducing .NET 5

Rich Lander [MSFT]

Today, we’re announcing that the next release after .NET Core 3.0 will be .NET 5. This will be the next big release in the .NET family.

There will be just one .NET going forward, and you will be able to use it to target Windows, Linux, macOS, iOS, Android, tvOS, watchOS and WebAssembly and more.

We will introduce new .NET APIs, runtime capabilities and language features as part of .NET 5.

From the inception of the .NET Core project, we’ve added around fifty thousand .NET Framework APIs to the platform. .NET Core 3.0 closes much of the remaining capability gap with .NET Framework 4.8, enabling Windows Forms, WPF and Entity Framework 6. .NET 5 builds on this work, taking .NET Core and the best of Mono to create a single platform that you can use for all your modern .NET code.

We intend to release .NET 5 in November 2020, with the first preview available in the first half of 2020. It will be supported with future updates to Visual Studio 2019, Visual Studio for Mac and Visual Studio Code.

Check out .NET Core is the Future of .NET to understand how .NET 5 relates to .NET Framework.

.NET 5 = .NET Core vNext

.NET 5 is the next step forward with .NET Core. The project aims to improve .NET in a few key ways:

  • Produce a single .NET runtime and framework that can be used everywhere and that has uniform runtime behaviors and developer experiences.
  • Expand the capabilities of .NET by taking the best of .NET Core, .NET Framework, Xamarin and Mono.
  • Build that product out of a single code-base that developers (Microsoft and the community) can work on and expand together and that improves all scenarios.

This new project and direction are a game-changer for .NET. With .NET 5, your code and project files will look and feel the same no matter which type of app you’re building. You’ll have access to the same runtime, API and language capabilities with each app. This includes new performance improvements that get committed to corefx, practically daily.

Everything you love about .NET Core will continue to exist:

  • Open source and community-oriented on GitHub.
  • Cross-platform implementation.
  • Support for leveraging platform-specific capabilities, such as Windows Forms and WPF on Windows and the native bindings to each native platform from Xamarin.
  • High performance.
  • Side-by-side installation.
  • Small project files (SDK-style).
  • Capable command-line interface (CLI).
  • Visual Studio, Visual Studio for Mac, and Visual Studio Code integration.

Here’s what will be new:

  • You will have more choice on runtime experiences (more on that below).
  • Java interoperability will be available on all platforms.
  • Objective-C and Swift interoperability will be supported on multiple operating systems.
  • CoreFX will be extended to support static compilation of .NET (ahead-of-time – AOT), smaller footprints and support for more operating systems.

We will ship .NET Core 3.0 this September, .NET 5 in November 2020, and then we intend to ship a major version of .NET once a year, every November:

We’re skipping the version 4 because it would confuse users that are familiar with the .NET Framework, which has been using the 4.x series for a long time. Additionally, we wanted to clearly communicate that .NET 5 is the future for the .NET platform.

We are also taking the opportunity to simplify naming. We thought that if there is only one .NET going forward, we don’t need a clarifying term like “Core”. The shorter name is a simplification and also communicates that .NET 5 has uniform capabilities and behaviors. Feel free to continue to use the “.NET Core” name if you prefer it.

Runtime experiences

Mono is the original cross-platform implementation of .NET. It started out as an open-source alternative to .NET Framework and transitioned to targeting mobile devices as iOS and Android devices became popular. Mono is the runtime used as part of Xamarin.

CoreCLR is the runtime used as part of .NET Core. It has been primarily targeted at supporting cloud applications, including the largest services at Microsoft, and now is also being used for Windows desktop, IoT and machine learning applications.

Taken together, the .NET Core and Mono runtimes have a lot of similarities (they are both .NET runtimes after all) but also valuable unique capabilities. It makes sense to make it possible to pick the runtime experience you want. We’re in the process of making CoreCLR and Mono drop-in replacements for one another. We will make it as simple as a build switch to choose between the different runtime options.

The following sections describe the primary pivots we are planning for .NET 5. They provide a clear view on how we plan to evolve the two runtimes individually, and also together.

High throughput and high productivity

From the very beginning, .NET has relied on a just-in-time compiler (JIT) to translate Intermediate Language (IL) code to optimized machine code. Since that time, we’ve built an industry-leading JIT-based managed runtime that is capable of very high throughput and also enabled developer experiences that make programming fast and easy.

JITs are well suited for long-running cloud and client scenarios. They are able to generate code that targets a specific machine configuration, including specific CPU instructions. A JIT can also re-generate methods at runtime, a technique used to JIT quickly while still having the option to produce a highly-tuned version of the code if this becomes a frequently used method.

Our efforts to make ASP.NET Core run faster on the TechEmpower benchmarks is a good example of the power of JIT and our investments in CoreCLR. Our efforts to harden .NET Core for containers also demonstrates the runtime’s ability to dynamically adapt to constrained environments.

Developer tools are another good example where JIT shines, such as with the dotnet watch tool or edit and continue. Tools often require compiling and loading code multiple times in a single process without restarting and need to do it very quickly.

Developers using .NET Core or .NET Framework have primarily relied on JIT. As a result, this experience should seem familiar.

The default experience for most .NET 5 workloads will be using the JIT-based CoreCLR runtime. The two notable exceptions are iOS and client-side Blazor (web assembly) since both require ahead-of-time (AOT) native compilation.

Fast startup, low footprint, and lower memory usage

The Mono Project has spent much of its effort focused on mobile and gaming consoles. A key capability and outcome of that project is an AOT compiler for .NET, based on the industry-leading LLVM compiler project. The Mono AOT compiler enables .NET code to be built into a single native code executable that can run on a machine, much like C++ code. AOT-compiled apps can run efficiently in small places, and trades throughput for startup if needed.

The Blazor project is already using the Mono AOT. It will be one of the first projects to transition to .NET 5. We are using it as one of the scenarios to prove out this plan.

There are two types of AOT solutions:

  • solutions that require 100% AOT compilation.
  • solutions where most code is AOT-compiled but where a JIT or interpreter is available and used for code patterns that are not friendly to AOT (like generics).

The Mono AOT supports both cases. The first type of AOT is required by Apple for iOS and some game consoles, typically for security reasons. The second is the preferred choice since it offers the benefits of AOT without any of its drawbacks.

.NET Native is the AOT compiler we use for Windows UWP applications and is an example of the first type of AOT listed above. With that particular implementation, we limited the .NET APIs and capabilities that you can use. We learned from that experience that AOT solutions need to cover the full spectrum of .NET APIs and patterns.

AOT compilation will remain required for iOS, web assembly and some game consoles. We will make AOT compilation an option for applications that are more appliance-like, that require fast startup and/or low footprint.

Fundamentals and overlapping experiences

It is critical that we continue to move forward as an overall platform with startup, throughput, memory use, reliability, and diagnostics. At the same time, it also makes sense to focus our efforts. We’ll invest more in throughput and reliability in CoreCLR while we invest more in startup and size reduction with the Mono AOT compiler. We think that these are good pairings. Throughput and reliability go together as do startup and size reduction.

While there are some characteristics where it makes sense to make different investments, there are others that do not.

Diagnostics capabilities need to be the same across .NET 5, for both functional and performance diagnostics. It is also important to support the same chips and operating systems (with the exception of iOS and web assembly).

We will continue to optimize .NET 5 for each workload and scenario, for whatever makes sense. There will be even greater emphasis on optimizations, particular where multiple workloads have overlapping needs.

All .NET 5 applications will use the CoreFX framework. We will ensure that CoreFX works well in the places it is not used today, which is primarily the Xamarin and client-side Blazor workloads. All .NET 5 applications will be buildable with the .NET CLI, ensuring that you have common command-line tooling across projects.

C# will move forward in lock-step with .NET 5. Developers writing .NET 5 apps will have access to the latest C# version and features.

The birth of the project

We met as a technical team in December 2018 in Boston to kick off this project. Design leaders from .NET teams (Mono/Xamarin and .NET Core) and also from Unity presented on various technical capabilities and architectural direction.

We are now moving forward on this project as a single team with one set of deliverables. Since December, we have made a lot of progress on a few projects:

  • Defined a minimal layer that defines the runtime <-> managed code layer, with the goal making >99% of CoreFX common code.
  • MonoVM can now use CoreFX and its class libraries.
  • Run all CoreFX tests on MonoVM using the CoreFX implementation.
  • Run ASP.NET Core 3.0 apps with MonoVM.
  • Run MonoDevelop and then Visual Studio for Mac on CoreCLR.

Moving to a single .NET implementation raises important questions. What will the target framework be? Will NuGet package compatibility rules be the same? Which workloads should be supported out-of-the-box by the .NET 5 SDK? How does writing code for a specific architecture work? Do we still need .NET Standard? We are working through these issues now and will soon be sharing design docs for you to read and give feedback on.


The .NET 5 project is an important and exciting new direction for .NET. You will see .NET become simpler but also have broader and more expansive capability and utility. All new development and feature capabilities will be part of .NET 5, including new C# versions.

We see a bright future ahead in which you can use the same .NET APIs and languages to target a broad range of application types, operating systems, and chip architectures. It will be easy to make changes to your build configuration to build your applications differently, in Visual Studio, Visual Studio for Mac, Visual Studio Code, Azure DevOps or at the command line.

See: .NET 5 on Hacker News


Discussion is closed. Login to edit/delete existing comments.

  • Leonardo Zambonelli 0

    What about UI? Will.a common technology be present in the future?

  • Shimmy Weitzhandler 0

    Nothing interesting. Microsoft fails to include a cross-platform UI solution year after year.

    Xamarin.Forms is dropping Windows support, and doesn’t target web, aside from being a sloppy and messed up library. The only close solution out there is the Uno Platform, which gets zero recognition from MS. It’s not even in the .NET Foundation.

    If you find that this matter applies to you too, please vote on this dev community request.

    Really disappointed. A good technology without a UI is like a unicorn without a horn. That’s what .NET is.

    • Paul Sinclair 0

      Best comment. An officially supported cross platform GUI with .Net is needed otherwise for me using a game engine like Unity is the only sane way of targetting multiple platforms, with a consistant GUI and being able to use C#… 

    • Pierce BogganMicrosoft employee 0

      Hi Shimmy & Paul,
      I work as a PM on the Visual Studio and .NET teams. I’d be interested in learning more about your specific development scenarios and needs for a cross-platform UI. Mind sending me an email at to set some time up for discussion?

  • haidong gao 0

    net5 支持webform winform wpf wf wcf跨平台吗

  • Sam 0

    You guys have to do something about WebForms. There are tens of thousands of websites that use WebForms. Most of those are probably in maintenance mode. This isn’t like Silverlight where adoption was much more narrow and mostly limited to enterprises. If no upgrade path is made for Web Forms, you’ll eventually have huge swaths of the web running on an insecure framework once your extended support for .NET Framework ends. Not to mention all those sites never receiving any of the perf benefits from all the work going into Core.
    And not only that, it is in Microsoft’s financial interest as well. Every single Web Forms site is sitting on a Windows Server that someone pays a license fee for. Once you essentially tell all those website owners they are on an abandoned framework and need to rebuild their sites, many will almost certainly will rebuild the sites in a web framework that doesn’t require a Windows license (including ASP.NET Core).

    • Tsahi Asher 0

      .NET Framework isn’t going away anytime soon. As they write in a later blog post, it will continue to live and receive patches.

      • Anthony Roy 0

        We need assurances on how long on this. I would say there are tens of millions of websites that use WebForms and when everyone realises that these may not be supported they and me will not be happy. Do you know how long the original .net web form frame work will be supported until?

        Thanks in advance.

    • Anthony Roy 0

      1. There are more likely tens of millions of websites that use web forms.
      2. We are like you, we have had no need to take .net core seriously because we have everything we needed in WebForms. Our main problem is that we have millions up millions of lines of code from Document scanning modules, to Web Service Data importation APIs to Advance Loan Servicing platforms to Advanced document origination systems to Custom Forms modules where clients can add in their own forms and tables etc etc and to rewrite all of these will take us many years.
      3. We have seen many fads from the original MVC frameworks to now this open source and no one really cares where the systems are hosted and I prefer windows servers because we understand them. Our systems run in a web browser and can be used on Mac or Linux machine anyway so who cares.
      4. I cannot believe MS is not going to port web forms.

  • Thomas Mutzl 0

    What about the Entity Framework in .NET 5? EF 6 and EF Core have differences. Will both versions be supported?

    • Scott HunterMicrosoft employee 0

      .NET Core 3 includes EF 6 so yes it will be part of .NET 5 as well.

      • TBD TBD 0

        what about the EF6 tooling. edmx is hosed in VS2019, is this the future?

  • Andrew Witte 0

    Where does CoreRT play into this as its not mentioned. Is there no change and it will continue to be the CoreCLR AOT backend for non UWP targets? Really hope .NET Native just merges into CoreRT. I never understood making such a unportable yet most beneficial runtime stuck in a nitch enviroment. Much of that work just goes down the drain for most people.

    AOT seems to be if not more the most relevent target anymore. The JIT has really never had any value to me personally (other than the very rare off-chance I want to edit code while the app is running which I could live without) and for the most part caused more problems than its solves as its slower in almost any angle you look at it and harder to port. If more focus was on AOT initially .NET would be having a lot less issues now is my guess. At this point the JIT vs AOT experiment has shown AOT to be the big winner for most spaces in my mind so glad to see more effort there.

    Also QUOTE: “Today, we’re announcing that the next release after .NET Core 3.0”
    This should say .NET Core 3.1 maybe 😉

    • Scott HunterMicrosoft employee 0

      Rich mentioned in the post that .NET 5 will include AOT. Sort of the best of .NET Native and Mono combined.

  • Jaime Vasquez 0

    And in .NET Framework 5, will be exists the possibility to develop a Desktop Application “multiplatform” that works in Windows, Linux and Mac?

    • Andrew Witte 0

      .NET Framework 5 will never be a thing. Thats why they’re calling this .NET 5

      • Jaime Vasquez 0

        Ok. In .NET 5, will be exists the possibility to develop a Desktop Application “multiplatform” that works in Windows, Linux and Mac?

        • Andrew Witte 0

          Yes just as you can with Mono or .NET Core now. This doesn’t mean Windows UI are cross platform. You have to use something like Xamarin.Forms or Avalonia etc that was designed for potability. Not what people want but there are very few very ‘ok’ UI options in the .NET UI world.

    • Pierce BogganMicrosoft employee 0

      Hi Jamie, I work as a PM on the Visual Studio and .NET teams. I’d be interested in learning more about your specific development scenarios and needs for a cross-platform UI. Mind sending me an email at to set some time up for discussion?

  • haidong gao 0

    Does webform  support cross-platform

    • Scott HunterMicrosoft employee 0

      WinForms is a wrapper around HWND in Windows, so it is not cross platform. Even if it was you would not want a Windows 95 looking application on Mac or Linux. Cross platform UI needs something a little different. We are looking at that space but we don’t know the right answer yet. Is it Xamarin Forms, is it Blazor + Electron, is it something else.

    • Tsahi Asher 0

      No. WebForms is tied to IIS, and must run on Windows. Hence, it won’t be ported to .NET Core.

  • Alexander Zaytsev 0

    The one thing notably missing from the post is any mention of being able to statically AOT compile a web app with this new paradigm. I am sure a lot people would agree that this scenario would be a major help in a lot of very simple applications that are called millions of times. I understand that is probably one of the more difficult use cases, but one that would be awesome to see realised.

    • Scott HunterMicrosoft employee 0

      We mentioned that AOT will be available for all .NET projects in .NET 5. That means you can static link ANY .NET project.

  • matari ganan 0

    A question that comes to mind is:If I wrote something with 4.7 which may have features not available to Core 3.0 and then .NET 5 rolls out, will what I wrote not work in .NET 5?

Feedback usabilla icon