126

According to the documentation, Razor views should, by default, recompile on change on local environments for ASP.NET Core 3.0.

However, my project doesn't do this locally. If I change a view and refresh when I'm debugging locally, the change is not reflected. I have to stop the solution, re-run, and then see the change.

I am doing this on a default ASP.NET Core Web Application template on Visual Studio 2019 with ASP.NET Core 3.0.0 Preview 2 using Razor pages. Any idea if I need to change settings to enable this feature?

Zoe
  • 27,060
  • 21
  • 118
  • 148
tarun713
  • 2,177
  • 3
  • 17
  • 31
  • .cshtml razor views do get recompiled. Can you double check? Try adding a

    Test

    . Start the app, load the page. you should see "Test". Then change this to

    Foo

    . You should see "Foo".
    – John-Luke Laue Feb 08 '19 at 23:06
  • Doesn't work! I have to stop and start the solution. Captured it here: https://drive.google.com/file/d/1xOWQK2SvE2dskSYRdLz9X7iEmAv7BcTN/view?usp=sharing - Have tried on multiple machines with the stock Razor Pages template. – tarun713 Feb 08 '19 at 23:42
  • Are you running a on mac or pc or linux? Also, it might be an issue with the preview. Can you try using asp.net core 2.x? – John-Luke Laue Feb 09 '19 at 01:00
  • PC, Visual Studio 2019 preview. I tried with 2.2 and it works! So there's something that changed in 3.0. – tarun713 Feb 09 '19 at 15:33
  • I am on a fully updated .net core 3/VS and had to add `.AddRazorRuntimeCompilation();` Thank you! – duck Nov 14 '19 at 19:11

9 Answers9

77

For ASP.NET Core 3 release version:

   services.AddControllersWithViews().AddRazorRuntimeCompilation();

https://learn.microsoft.com/en-us/aspnet/core/mvc/views/view-compilation?view=aspnetcore-3.0

It can also be enabled conditionally only for local development, quoted from the link:

Runtime compilation can be enabled such that it's only available for local development. Conditionally enabling in this manner ensures that the published output:

Uses compiled views.
Is smaller in size.
Doesn't enable file watchers in production.

   public Startup(IConfiguration configuration, IWebHostEnvironment env)
    {
        Configuration = configuration;
        Env = env;
    }

    public IWebHostEnvironment Env { get; set; }
    public IConfiguration Configuration { get; }

    public void ConfigureServices(IServiceCollection services)
    {
        IMvcBuilder builder = services.AddRazorPages();

#if DEBUG
            if (Env.IsDevelopment())
            {
                builder.AddRazorRuntimeCompilation();
            }
#endif
    }
Rauland
  • 2,944
  • 5
  • 34
  • 44
  • Tip about versions of the nuget package related to .Net core version. In case you use .Net Core 3.0, you cannot select the later versions of this Nuget package. But version 3.0.0 of the Nuget lib works with .Net Core 3.0. If you use .Net Core 3.1, you can select newer versions. – Tore Aurstad Jun 29 '20 at 22:56
69

OK it looks like it's not supported yet :(

Runtime compilation removed As a consequence of cleaning up the ASP.NET Core shared framework to not depend on Roslyn, support for runtime compilation of pages and views has also been removed in this preview release. Instead compilation of pages and views is performed at build time. In a future preview update we will provide a NuGet packages for optionally enabling runtime compilation support in an app.

You can read more about the issue here https://github.com/aspnet/Announcements/issues/343

Applications that require runtime compilation or re-compilation of Razor files should:

  • Add a reference to the Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation package. It'll be available as part of the 3.0.0-preview3 release.
  • Update the application's ConfigureServices to include a call to AddMvcRazorRuntimeCompilation:
Lukáš Kmoch
  • 1,239
  • 11
  • 11
43

To get runtime view compilation back in ASP.NET Core 3

  1. Reference Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation
  2. Call services.AddMvc().AddRazorRuntimeCompilation()
  3. Remove Microsoft.VisualStudio.Web.CodeGeneration.Design if there's a version mismatch on the Microsoft.CodeAnalysis.Common package
Dmitry Pavlov
  • 30,789
  • 8
  • 97
  • 121
  • 2
    Just a hint for others: when using Nuget, tick/check the "pre-release" box. – GeoffM Jun 07 '19 at 21:16
  • Is there a way to prevent the assets from being deployed to production? I tried some combinations of PrivateAssets on the PackageReference but it doesn't seem to work. – Chet Sep 27 '19 at 15:40
  • In Core 2.2 razor options has FileProviders and it works even without any recompilation. Just edit cshtml and voila. In core 3 this property is removed. :( https://github.com/aspnet/AspNetCore/issues/14572 – dariol Oct 04 '19 at 08:46
  • 3
    +1 because removing the Microsoft.VisualStudio.Web.CodeGeneration.Design package was the secret sauce that nowhere else mentions. – tkburbidge Mar 08 '20 at 00:36
  • @tkburbidge I just ran into that issue with the package, too. Oddly enough, I had two lines that were exactly the same, back-to-back. I removed both, and could compile. **Even more oddly**, I then put the lines back in place, and was still able to compile. – Lynn Crumbling Mar 09 '20 at 15:47
28

Runtime compilation is enabled using the Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation package. To enable runtime compilation, apps must:

  1. Install the Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation NuGet package.

  2. Update the project's Startup.ConfigureServices method to include a call to AddRazorRuntimeCompilation:

services
    .AddControllersWithViews()
    .AddRazorRuntimeCompilation();

https://learn.microsoft.com/en-us/aspnet/core/mvc/views/view-compilation?view=aspnetcore-3.0

kevic
  • 449
  • 4
  • 6
20

To get runtime Razor Views Compilation back in ASP.NET Core 3.1:

  1. Install the Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation NuGet package.
  2. Update the project's Startup.ConfigureServices method to include a call to AddRazorRuntimeCompilation.
  3. services.AddRazorPages().AddRazorRuntimeCompilation();

    Razor file compilation in ASP.NET Core 3.1

Naman Upadhyay
  • 531
  • 6
  • 12
16

Step 1: Install the below package from NuGet Package Manager for Solution.

Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation

Step 2: Add the below code in ConfigureServices of Startup.cs file

services.AddControllersWithViews().AddRazorRuntimeCompilation();

Save the page and then refresh the client browser.

If you are using Razor then add the code for services.AddRazorPages().AddRazorRuntimeCompilation();

Nathan
  • 1,303
  • 12
  • 26
psuneel127
  • 171
  • 1
  • 5
13

In .NET Core 3.1, you need disable generation of the views.dll file.

  1. Add the below code to your .csproj file (in the root of your project):

    <PropertyGroup>
        <TargetFramework>netcoreapp3.1</TargetFramework>
        <UserSecretsId>...</UserSecretsId>
    
        <!-- add from this line: -->
        <CopyRazorGenerateFilesToPublishDirectory>true</CopyRazorGenerateFilesToPublishDirectory>
        <CopyRefAssembliesToPublishDirectory>false</CopyRefAssembliesToPublishDirectory>
        <MvcRazorCompileOnPublish>false</MvcRazorCompileOnPublish>
        <RazorCompileOnBuild>false</RazorCompileOnBuild>
        <!-- to this line. -->
    
    </PropertyGroup>
    
  2. Install the below package from the NuGet Package Manager for the Solution.

    Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation
    
  3. Add the below code to the ConfigureServices method of your Startup.cs file:

    services.AddMvc().AddRazorRuntimeCompilation();
    

    Or

    services.AddControllersWithViews().AddRazorRuntimeCompilation();
    

    Or

    services.AddRazorPages().AddRazorRuntimeCompilation();
    

After this, publish again and run it. It will work.

Jeremy Caney
  • 7,102
  • 69
  • 48
  • 77
Ali Rasouli
  • 1,705
  • 18
  • 25
7

Simpliest way to configure Runtime Compilation for Local Development only is to update launch profiles in launchSettings.json. This method requires no code changes to configure a project which is running locally (it will not affect your production).

See the official documentation:

  1. Install the Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation NuGet package.
  2. Modify the launch profile environmentVariables section in launchSettings.json:
    • Verify ASPNETCORE_ENVIRONMENT is set to "Development".
    • Set ASPNETCORE_HOSTINGSTARTUPASSEMBLIES to "Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation".

Example:

{
  "iisSettings": {
    "windowsAuthentication": false,
    "anonymousAuthentication": true,
    "iisExpress": {
      "applicationUrl": "http://localhost:57676",
      "sslPort": 44364
    }
  },
  "profiles": {
    "IIS Express": {
      "commandName": "IISExpress",
      "launchBrowser": true,
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development",
        "ASPNETCORE_HOSTINGSTARTUPASSEMBLIES": "Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation"
      }
    },
    "RazorPagesApp": {
      "commandName": "Project",
      "launchBrowser": true,
      "applicationUrl": "https://localhost:5001;http://localhost:5000",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development",
        "ASPNETCORE_HOSTINGSTARTUPASSEMBLIES": "Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation"
      }
    }
  }
}
Siarhei Kavaleuski
  • 1,450
  • 14
  • 15
6

Just an added note -- you may want to only conditionally enable this runtime compilation, so that the published output:

  • Uses compiled views.
  • Is smaller in size.
  • Doesn't enable file watchers in production.

Conditionally enable runtime compilation

BryanCass
  • 333
  • 2
  • 11