What is the best way to use Razor in a console application

Related searches

I know similar questions have been asked before, but the only answers are six years old, and the projects people refer to seem like they're not being maintained.

I want to use Razor in a console app or a class library to render HTML. I would also like to have working Intellisense in the .cshtml files.

Currently, I am able to jury-rig this by doing the following:

  • Create console app.
  • Add .cshtml file.
  • In Properties, set the Custom Tool property to RazorTemplatePreprocessor

This causes Razor syntax to be recognized. So if you have Test.cshtml, it generates a class called Test that you can use like so:

var test = new Test();
test.Model = "Hi there";
var html = test.GenerateString();


This is just about good enough for my purposes. However, the actual coding experience within the .cshtml file is pretty broken:

  • There are red squigglies all over the place complaining about:
    • Not being able to use var because it's C# 2.
    • Saying the type or namespace of various types can't be found.
    • The above is especially true of types imported from other libraries.
  • The @model keyword is not recognized.
  • Intellisense sometimes works, sometimes doesn't.

Weirdly, if you just ignore all of these errors, the HTML is actually generated correctly, including use of the libraries and @model keyword that the Razor engine complained about. However, this causes major mental clutter because if you have any number of .cshtml files, you very quickly get into hundreds and thousands of these errors mixed in with real errors.

Is there anything I can do to cause the actual Razor coding experience to work more like it does in an ASP.NET web app?

UPDATE (2/13/2020)

I have things working in a mostly non-clunky way. Please see my answer below.

Just use RazorEngine library.

cshtml file intellisense is supported as per documentation.

Using Razor in a Console Application (outside of , How to render Razor in a Console application or outside of ASP.NET Core MVC. Best suited for generating HTML Email content. This series of tutorials shows how to use Razor Pages in ASP.NET Core. Learn how to create a model, generate code for Razor pages, use Entity Framework Core and SQL Server for data access, add search functionality, add input validation, and use migrations to update the model.

I have been working on this sporadically since I asked the question nearly two years ago, and I believe I have a 99% non-clunky solution. Everything below works for me in Visual Studio 16.4.5.

Here's what I have learned about getting Razor to work in console and library projects.

  1. Everything seems to work with the least trouble if create and consume your Razor files in a .NET Core console app.
  2. You can also put your Razor files in a .NET Standard library and consume them from a .NET Core console app, though in this case there is some minor ugliness in Solution Explorer. I don't think it has any effect on functionality, however.
  3. Either way, both the @model and the @using keywords work correctly, Intellisense works correctly, lambda expressions work correctly, everything seems to work properly.

Here's what you have to do:

To add a Razor file:

Add a new HTML file, but name the file with a .cshtml extension.

Select the file in Solution Explorer. In the Properties window, under Custom Tool, enter RazorTemplatePreprocessor. A .cs file will immediately be generated.

To consume the generated class:

var razor = new MyRazorClass();
razor.Model = "Hello from Razor";       // Assumes @model string in the Razor file; custom classes are fine too.
var html = razor.GenerateString();

To resolve the errors in the Error List (which incidentally do not seem to affect functionality but certainly create mental clutter):

Add NuGet references to:


If you are adding your Razor files to a .NET Standard library, you'll get a bunch of the following errors:

Feature 'nullable reference types' is not available in C# 7.3. Please use language version 8.0 or greater.

To fix this, add the following two lines to the project file:

  <Nullable>enable</Nullable>                         <!-- Add this line -->
  <LangVersion>8.0</LangVersion>                      <!-- Add this line -->

At this point, the project should compile with no errors or warnings!

However, it doesn't work perfectly. There some oddities, which give me some concern that things might unexpectedly break on me in the future.

These problems only seem to occur when using Razor files from .NET Standard libraries:

  1. The Solution Explorer sometimes shows the descendants of the .cshtml file in two different ways:

    a. In what I believe is the correct way, the .cshtml file has as its only descendant a generated .cs file. That file in turn has two generated classes, YourRazorClass and YourRazorClassBase. Each of those can be expanded to show the class members, which have nice, human-readable names.

    b. Sometimes, however, an underscore-prefixed class appears as a direct descendant of the .cshtml file (e.g., _MyTestRazorClass), Also, its class members are different.

    This seems to appear and disappear from the Solution Explorer and I don't think it causes any harm, but it certainly causes some mental clutter as you wonder what on earth is going on.

  2. In Solution Explorer, under the [Project Name] > Dependencies > Analyzers, there are a bunch of warnings that get propagated up into the same section of any project that consumes the library. This also creates mental clutter. Fortunately, you can turn these off by doing the following:

    a. Right-click the project and choose Properties. b. Under Code Analysis, uncheck the Run on Build and Run on Live Analysis boxes.

One final note: I have not yet tested using a .NET Standard library set up in this way inside a Xamarin project yet (this is the scenario that originally had me going down this road), but I will do so in the future and update this answer at that time.

I hope this helps someone. And if anyone figures out what is going on with the weirdness in Solution Explorer, I would love to know!

What is the best way to use Razor in a console application, I want to use Razor in a console app or a class library to render HTML. I would also like to have working Intellisense in the .cshtml files. Currently, I am able to� Razor allows you to switch between HTML markup and C# in the same file with IntelliSense support. Razor Pages and MVC also use Razor. Unlike Razor Pages and MVC, which are built around a request/response model, components are used specifically for client-side UI logic and composition.

I usually use T4 Templates outside ASP.NET app: https://msdn.microsoft.com/en-US/library/bb126445.aspx. There are several plugins for Visual Studio which enable code highlighting, for example http://t4-editor.tangible-engineering.com/T4-Editor-Visual-T4-Editing.html.

Of course, T4 is not equivalent to Razor and you should learn syntax in order to use it, but I think using Razor outside webapp is bad style...

Using T4 you can create from templates your own classes with custom strongly typed properties and constructors, and that's much more than Razor can.

How to integrate the MVC Razor Engine, using Roslyn, in a .NET , How to integrate the MVC Razor Engine, using Roslyn, in a .NET Core 2 Console Application NET compiler, to leverage the Razor Engine in other project types, and define your project in a way that better suits you. The code will be based on RazorEngine 3.4, Razor 3.0 and ASP.NET MVC 5. In this series of blog post and to keep things simple, we'll be generating emails from a console application. Unless otherwise noted, the code should work in the exact same way within the context of an ASP.NET application, a desktop application or a Windows Service.

You can upgrade to C#4 by adding the nuget packgage:


This will give you the var keyword.

Also, you can get intellisense for your template parameters doing the following

  1. Create a new .cs file
  2. Inside it, add a partial class with the same name as the one automaticaly generated by the .cshtml file. Something like that:

public partial class htmlRazor : htmlRazorBase { public DateTime myDate}

  1. Add a constructor to this partial class that will take some input parameters:

public htmlRazor(DateTime _mydate) {myDate = _mydate}

  1. Add the following lines at the top of your .cshtml file:

@using yourNameSpace @*Make sure the parameter below have exactly the same name as the variable inside the partial class (public DateTime myDate). This line will be full of errors, but you can safely ignore them.*@ @{htmlRazor agrs = new htmlRazor(myDate);}

You can now access your parameters inside the razor code by doing agrs.myDate for exemple.

As a last note, my razor project is actualy a class library (creates a .dll file). I reference this library from a second console application project. I then create the html from the template like that:

htmlRazor html = new htmlRazor(DateTime.Now); string htmlTxt = html.GenerateString();

Using Razor in a Console Application (outside of ASP.NET , Using Razor in a Console Application (outside of ASP. This project shows how can Dapr and . Can you think of pros/cons of one over the other please? 23. First of all, there will be a simple guide on a basic API calling via a C# console application. Secondary, we will implement some sort of web app via ASP.NET Core. How to call an API in C# Prerequisites. As the tech stack, it is required to have a .NET package. We will use .NET Core, which is portable, lightweight and supportable for many

Generate Outputs with Razor Engine in .NET Core, NET MVC does utilize Razor as its HTML rendering engine. In this post, we'll see how we can utilize the Razor engine to generate dynamic input without needing the ASP. In a console application, we can now create our first usage. The good news is we can use Razor too for our bespoke needs. Non-host console app. For an example of how to use the Generic Host in a non-web console app, see the Program.cs file of the Background Tasks sample app (Background tasks with hosted services in ASP.NET Core). Logging code for apps without Generic Host differs in the way providers are added and loggers are created. Logging providers

Using properties is a great way to configure your filters, model binders, etc. on a per-action basis. Note The ActionDescriptor.Properties collection isn't thread safe (for writes) once app startup has finished.

C# (CSharp) developers using the .NET Framework are always looking for the best way to reverse a string. And fortunately, the C# reverse string function provides an easy-to-use and convenient way to do this using the .NET libraries.

  • Check out my 6 months old answer here: stackoverflow.com/a/47756437/403671 it's pure razor w/o any ASP.NET nor MVC dependency. Note that .cshtml files are not "razor", they are ASP.NET MVC so you won't have that in a razor console app (unless you emulate it in some way).
  • @SimonMourier Thanks for the reply. This is really great! One drawback is that it seems that the idea is to work with files as just text with no editor support. Is there any way to get some basic design-time support within Visual Studio just so that it will recognize Razor blocks and HTML, for example?
  • That I don't know, and have not investigated.
  • You can simply use run-time t4 templates. You can download/clone a working example here.
  • thank you for the reply. I want to use Razor because I'd like to reuse/repurpose templates that were developed for a website. However, I will take a look at T4 as well.
  • Doesn't answer the question.