Click here to Skip to main content
13,901,218 members
Click here to Skip to main content
Add your own
alternative version


19 bookmarked
Posted 8 Feb 2017
Licenced CPOL

Pre-compiled Razor View in ASP.NET MVC

, 16 Feb 2017
Rate this:
Please Sign up or sign in to vote.
Pre-compiled Razor view in ASP.NET MVC


Few months ago, I was developing a website using ASP.NET MVC. I found that there are difficulties to manage deployment if the number of views are huge. View does not generate compile time errors. I Googled and found there are ways to generate a single DLL for an MVC application instead of deploying all .cshtml files. I am going to share the techniques to enable pre-compilation of razor view and single DLL deployment.


One of the features of any compiled language is to validate errors and warnings at compile time. It reduces number of errors at the design phase instead of after running the program. ASP.NET MVC follows a mixed approach for compilation. Models and controllers are pre-compiled but views are compiled at runtime. So, any error in view can’t be detected until it is not run on the browser.
As views are not pre-compiled, startup time to load a MVC application will be slowed down if there are many views in a project.

To overcome this problem, views can be pre-compiled. We are going to discuss how we can do that.

Let’s start with an example.

Using the Code

Open Visual Studio.

Select MVC Web Application.
Select Basic template.
Create a controller Home.

Write few lines of code in controller:

namespace PrecompileView.Controllers
    public class HomeController : Controller
        public ActionResult Index()
            ViewBag.myText = "999";
            return View();

Add a view called Index:

Open Index.cshtml file.
Add the following line with incorrect ViewBag spelling:

    ViewBag.Title = "Home Page";


Run the application.
The following runtime exception will occur:

Instead of getting this runtime error, we can enable pre-compilation of razor view to generate design time compilation error. There are various ways to enable pre-compilation in ASP.NET MVC application.
We will discuss the following approaches:

  • Razor pre-compilation using MvcBuildViews tag
  • Razor pre-compilation using RazorGenerator

Option #1 - Razor Pre-compilation using MvcBuildViews Tag

This can be achieved by changing value of the MvcBuildViews in .csProject.

Steps are as follows:

Unload the .csProject:

Edit .csProject:

We can set <MvcBuildViews>True</MvcBuildViews> to enable pre-compilation, but we can optionally set pre-compilation on Release build.
In the <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|AnyCPU' "> section, set the MvcBuildViews element to false: <MvcBuildViews>false</MvcBuildViews>.
In the <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|AnyCPU' "> section, set the MvcBuildViews element to true: <MvcBuildViews>true</MvcBuildViews>.

We need to save the project and reload it.
Now, if we rebuild the project in Debug mode, there will be no error.

We will get the error in Release build:

Option #2 - Razor Pre-compilation using RazorGenerator

Using the previous approach, we can enable pre-compilation, but we need the .cshtml files also to deploy. If we can bind the controller and view into a single DLL, it will be very handy to deploy. By using RazorGenerator, we can achieve that.

Steps are as follows:

Restore the .csProject file to the earlier state.

Go to Tools, then Extension Manager.

Search for Razor Generator.

Click the Download button.

Once the install has completed, restart Visual Studio.

Insert RazorGenerator in Custom Tool .

Click on Run Custom Tool on Index.cshtml.

Running the Custom Tool will generate Index.generated.cs file.

The .cshtml file is now compiled into Index.generated.cs file and it looks like the following:

Now, if we build the project, we will get the following compile time error.

We are going to correct the error and successfully build the project.

public class HomeController : Controller
       public ActionResult Index()
           ViewBag.myText = "999";
           return View();

Build will be successful now. Now we are going to observe the most interesting part of this approach and that is deployment.

Open Developer Command Prompt for Visual Studio.

Type ildasm.

Navigate through PrecompileView.dll. We can see that Index.cshtml is now a part of the DLL.

So, now .cshtml files are no longer required for deployment.

We can deploy only the PrecompileView.dll for our entire MVC application.

You can download the source code here.

Points of Interest

Using RazorGenerator, we can deploy a single DLL file for an MVC application. For any web application, CSS, JavaScript and image files are part of the application. We can set these files as embedded resources to generate a single DLL.


This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


About the Author

You may also be interested in...

Comments and Discussions

QuestionNice Article Pin
Chandra_NVS30-Jan-18 0:18
memberChandra_NVS30-Jan-18 0:18 
QuestionFolder Vviews Pin
Tytto30-Aug-17 3:55
memberTytto30-Aug-17 3:55 
QuestionError on Server Pin
Bryian Tan16-Feb-17 5:30
mveBryian Tan16-Feb-17 5:30 
QuestionAuto recompilation if cshtml are modified by external tools ? Pin
Cestbienmoi10-Feb-17 2:24
memberCestbienmoi10-Feb-17 2:24 
AnswerRe: Auto recompilation if cshtml are modified by external tools ? Pin
Sayantan Dutta10-Feb-17 18:03
memberSayantan Dutta10-Feb-17 18:03 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

Permalink | Advertise | Privacy | Cookies | Terms of Use | Mobile
Web01 | 2.8.190306.1 | Last Updated 16 Feb 2017
Article Copyright 2017 by Sayantan Dutta
Everything else Copyright © CodeProject, 1999-2019
Layout: fixed | fluid