Announcing .NET 5 Preview 1

Scott Hunter [MSFT]


At the end of last year, we shipped .NET Core 3.0 and 3.1. These versions added the desktop app models Windows Forms (WinForms) and WPF, ASP.NET Blazor for building single page applications and gRPC for cross-platform, contract-based messaging. We also added templates for building services, rich generation of client code for talking to gRPC, REST API services, and a lot more. We’re excited to see that .NET Core 3 has become the fastest adopted version of .NET ever and we’ve gained another million more users in just the last year.

We also communicated with these releases that this would conclude the porting of the app models from .NET Framework. With .NET Core 3, we have ported all of the most used app models as well as introduced newer cross- platform frameworks to replace the ones we did not port.

As we look forward to the next major release, .NET 5, we will continue to unify .NET into a single platform by including our .NET mobile device app model (Xamarin) in .NET 5. .NET 5 will include ASP.NET Core, Entity Framework Core, WinForms, WPF, Xamarin and ML.NET. For the first time, the entire platform will use a unified BCL (Base Class Libraries) for all the app models. Having a version 5 that is higher than both .NET Core and .NET Framework also makes it clear that .NET 5 is the future of .NET, which is a single unified platform for building any type of application.

We have said this many times, but we will reiterate again; .NET Core and then .NET 5 is the .NET you should build all your NEW applications with. .NET Framework will remain supported as long as Windows itself is supported. We will continue to provide security and bug fixes and keep the networking and crypto API’s up to date. It will remain safe and supported to keep your older applications on .NET Framework.

Install .NET 5.0 Preview 1

Today we are releasing the first preview of .NET 5, which is scheduled to GA (General Availability) later this year in November.

See ASP.NET Core updates in .NET 5 Preview 1 to learn about today’s ASP.NET Core release.

Preview 1 includes support for Windows ARM64 for the first time. Today’s release includes the .NET Core runtime. We expect Preview 2 to include the SDK (ASP.NET Core but not WPF or Windows Forms). A later preview will include WPF and Windows Forms. Support for Windows ARM64 will also be back-ported to .NET Core 3.1. We will share more information on that with the Preview 2 post.

Updating existing projects

You can update existing projects by updating your target framework, as follows:


High-level goals for .NET 5

Let me highlight some of the high-level goals for .NET 5:

  • Unified .NET SDK experience:
    • Single BCL (Base Class Library) across all .NET 5 applications. Today Xamarin applications use the Mono BCL but will move to use the.NET Core BCL, improving compatibility across our application models.
    • Mobile development (Xamarin) is integrated into .NET 5. This means the .NET SDK will support mobile. For example, you can use “dotnet new XamarinForms” to create a mobile application.
  • Native Applications supporting multiple platforms: Single Device project that supports an application that can work across multiple devices for example Window Desktop, Microsoft Duo (Android), and iOS using the native controls supported on those platforms.
  • Web Applications supporting multiple platforms: Single Blazor project that supports an application that can work in browsers, on mobile devices and as a native desktop application (Windows 10x for example)
  • Cloud Native Applications: High performance, single file (.exe) <50MB microservices and support for building multiple project (API, web front ends, containers) both locally and in the cloud.
  • Continuous Improvements, such as: faster algorithms in the BCL, better support for containers in the runtime, support for HTTP3.

Today’s first preview does not contain all the work to support these high-level goals yet, but we will continue to announce more capabilities and features in future previews.

Improvements in Preview 1

The following improvements are in Preview 1:

Regular expression performance improvements

We’ve invested in significant improvements to the Regex engine. On many of the expressions we’ve tried, these improvements routinely result in throughput improvements of 3-6x, and in some cases, much more. We have a blog post coming shortly that will describe these improvements in much more detail.

Code quality improvements in RyuJIT

Every release includes a set of performance improvements to the code that the JIT generates. We refer to these type of improvements as “CQ” or code quality. In most cases, these improvements also apply to the code generated for ready-to-run images.

The following improvements are in preview 1:

Assembly load diagnostics added to event pipe

We have added assembly load information to event pipe. This improvement is the start of making similar diagnostics functionality available as is part of .NET Framework with the Fusion Log Viewer. You can now use dotnet-trace to collect this information, using the following command:

dotnet-trace collect --providers Microsoft-Windows-DotNETRuntime:4:4 --process-id [process ID]

The workflow is described in Trace Assembly Loading with Event Pipe. You can see assembly loading information for a simple test app.

Image trace assemblies loads

Event pipe profiler APIs

Event pipe is a new subsystem and API that we added in .NET Core 2.2 to make it possible to perform performance and other diagnostic investigations on any operating system. In .NET 5.0, the event pipe has been extended to enable profilers to write event pipe events. This scenario is critical for instrumenting profilers that previously relied on ETW to monitor application behavior and performance.

GitHub repo consolidation

As part of the .NET 5 release, we reduced the number of GitHub repos we use to build and package .NET. Repo boundaries have a significant impact on many aspects of a project, including builds and issue management. With .NET Core 1.0, we had over 100 repos across ASP.NET, EF and .NET Core. With this latest release, we can now count the primary repos on one hand. We also moved nearly all repos to the dotnet org.

Check out the new, consolidated, repos:


We hope that you are excited about the work that is happening with .NET 5! The best way to prepare for .NET 5 is to move all of our .NET Core applications to 3.1- we will make the transition from .NET Core 3.1 to .NET 5 as painless as possible. And if you are still building applications on .NET Framework, please feel safe leaving those applications on .NET Framework but think of using .NET Core 3.1 for all your new applications. There are lots of exciting things coming to .NET!


Comments are closed. Login to edit/delete your existing comments

  • Avatar

    Mention of UWP is conspicuously absent from this announcement. A couple years ago those using WPF (myself included) had to look high and low for WPF support. Microsoft was endorsing UWP as the future; were we foolish to listen and make the plunge?

    Now it’s becoming ever harder to find anyone at Microsoft make mention of UWP, and all the online docs are starting to have WinUI as the placeholder for UWP (e.g. So what’s the real story with UWP?

    Making mention of gRPC is particularly painful to see if you’re a UWP developer because Microsoft has yet to invest the effort required to make it work with UWP even though the required changes to support UWP are trivial.

    You can imagine why it might be hard to get excited about these announcements, given the inconsistency in tech churn. May we please get a definitive statement about the UWP roadmap or whether there is one.

  • Avatar
    Irina Pykhova

    what do you mean by “A later preview will include WPF and Windows Forms”? We tried both WPF and WF apps, looks like almost everything what worked in .Net Core 3.1 also works in .Net 5 preview. Do you have some specific plan for changes in WF and WPF?

  • Avatar

    Are Microsoft in a position yet to talk about the future of .Net Standard? With a single framework (.Net 5) I could see the need for this to go away, but will Blazor client apps be running a cut-down version…..will .NetStandard be needed to bridge that gap?

  • Avatar
    Christian Wulff

    Will .NET 5 be updated by Windows Update or Microsoft Update?

    I don’t see much sense in a Microsoft framework used on client machines (not only on servers) when they can’t be patched centrally and easily.

  • Avatar
    debadutta pahadsing

    Great Work by Scott & Team.

    We have been using .net for our enterprise applications for almost 15 years.
    One obstacle we are facing in adopting .net core is the lack of report designer/ viewer tools.
    Any plan to include the same in .net core & vs 2019 or we need to turn to 3rd party vendors for the same?


  • Avatar
    Alexey Leonovich

    Any news about cross-platform UI framework in .NET 5.0?

  • Todd Fulton
    Todd Fulton

    Wow, this sounds like a big leap forward. As a linux user I’ve been enjoying getting into C# and F#. I know we’ve had Mono for a long time, but the name just reminds me of streptococcus, so I never touched it. I’ll say as a C++/python guy it’s nice having a strongly typed language with proper reflection and dynamic features when you want them, while not having to worry about (smart) pointers. C# feels like the best of C++ and python. My only wish is that we had free functions. Just saying, the C# and F# languages are really well designed imho, but, it would be nice to compile down to binary ahead of time, another user mentioned this previously in this same comments section, something similar to go.

    Feels like a good time to be picking up .Net. Super stoked about F# 5.

    Any support in VS Code for .Net 5? Maybe insiders?

  • Avatar
    Jerome Boyer

    What is the impact on SQLCLR?
    Currently there is a semi disconnect between various SQL version and the .NET being supported. SQL 2016-2019 expect. .NET 4.5
    Will code in .NET 5.0 be supported in these SQL versions?