Razor.Templating.Core
Using Razor for HTML templating was never been so easy like this. Render your .cshtml files into string easily using this library.
This project makes use of Razor SDK for precompiling the views.
Supported Application Types
.NET Core 3.0 | .NET Core 3.1 | .NET 5 | > .NET 6 | |
---|---|---|---|---|
Preferred Version | v1.6.0 | v1.6.0 | v1.6.0 | 1.9.0-rc.2 |
Console | โ | โ | โ | โ |
Api | โ | โ | โ | โ |
Mvc | โ | โ | โ | โ |
Worker Service | โ | โ | โ | โ |
WPF | โ | โ | โ | โ |
WinForms | โ | โ | โ | โ |
Azure Functions | โ | โ | โ | โ |
Supported View Features
MVC Razor View Features | |
---|---|
ViewModel | โ |
ViewBag | โ |
ViewData | โ |
Layouts | โ |
ViewStarts | โ |
ViewImports | โ |
Partial Views | โ |
Tag Helpers | โ |
View Components (.NET 5 +) | โ |
Dependency Injection into Views | โ |
@Url.ContentUrl** | โ |
@Url.RouteUrl** | โ |
**Contributors are welcome who can help to enable these unsupported features.
Applications
- Email Templating
- Report Generation & more
Installing Nuget Package
This library is available as Nuget package
Using .NET CLI
dotnet add package Razor.Templating.Core
Using Package Reference .csproj
<PackageReference Include="Razor.Templating.Core" Version="1.9.0-rc.2" />
Simple Usage:
using Razor.Templating.Core;
var model = new ExampleModel()
{
PlainText = "This text is rendered from Razor Views using Razor.Templating.Core",
HtmlContent = "<em>You can use it to generate email content, report generation and so on</em>"
};
// Both ViewBag and ViewData should be added to the same dictionary.
var viewDataOrViewBag = new Dictionary<string, object>();
// ViewData is same as mvc
viewDataOrViewBag["Value1"] = "1";
// ViewBag.Value2 can be written as below. There's no change on how it's accessed in .cshtml file
viewDataOrViewBag["Value2"] = "2";
var html = await RazorTemplateEngine.RenderAsync("/Views/ExampleView.cshtml", model, viewDataOrViewBag);
Before applying this code, follow this article for sample implementation: https://medium.com/@soundaranbu/render-razor-view-cshtml-to-string-in-net-core-7d125f32c79
Render View Without Layout
In case if there's a need to render a view without layout, use RenderParitalAsync()
method.
var html = await RazorTemplateEngine.RenderPartialAsync("/Views/ExampleView.cshtml", model, viewDataOrViewBag);
Razor Views in Library
Razor view files(.cshtml) can be organized in a separate shared Razor Class Libary(RCL). Sample library can be found here
The Razor Class Library's .csproj
file should look something like below. Whereas, AddRazorSupportForMvc
property is important.
Also, RCL should be referenced to the main project or where the RazorTemplateEngine.RenderAsync
method is invoked.
<Project Sdk="Microsoft.NET.Sdk.Razor">
<PropertyGroup>
<TargetFrameworks>net6.0</TargetFrameworks>
<AddRazorSupportForMvc>true</AddRazorSupportForMvc>
</PropertyGroup>
<ItemGroup>
<FrameworkReference Include="Microsoft.AspNetCore.App" />
</ItemGroup>
</Project>
Dependency Injection
Dependencies can be injected directly into views using @inject
in .csthml file. Refer sample application here
In ASP.NET Core, add dependency like below in Startup.cs -> ConfigureServices
...
services.AddTransient<ExampleService>();
//add after registering all the dependencies
services.AddRazorTemplating();
or in console or other applications, add as below
using Microsoft.Extensions.DependencyInjection;
// Add dependencies to the service collection
var services = new ServiceCollection();
services.AddTransient<ExampleService>();
// Add RazorTemplating after registering all dependencies
// this is important for the razor template engine to find the injected services
services.AddRazorTemplating();
Once the dependencies are registered, we can use either one of these ways:
RazorTemplateEngine
static class
Using var html = await RazorTemplateEngine.RenderAsync("~/Views/ExampleViewServiceInjection.cshtml");
IRazorTemplateEngine
Using - Instead of using the
RazorTemplateEngine
static class, it's also possible to use theIRazorTemplateEngine
interface to inject dependency directly into the constructor.
public class MyService {
private readonly IRazorTemplateEngine _razorTemplateEngine;
public MyService (IRazorTemplateEngine razorTemplateEngine)
{
_razorTemplateEngine = razorTemplateEngine;
}
public async Task Index()
{
var renderedView = await _razorTemplateEngine.RenderAsync("/Views/Home/Index.cshtml");
// do something with renderedView
}
}
How to render razor views from absolute path
We can make use of ASP.NET Core's inbuilt RazorRuntimeCompilation to render any .cshtml inside or outside of the project.
As of v1.7.0+
, we can achieve this as below:
using Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.FileProviders;
using Razor.Templating.Core;
var services = new ServiceCollection();
services.AddMvcCore().AddRazorRuntimeCompilation();
services.Configure<MvcRazorRuntimeCompilationOptions>(opts =>
{
opts.FileProviders.Add(new PhysicalFileProvider(@"D:\PathToRazorViews")); // This will be the root path
});
services.AddRazorTemplating();
var html = await RazorTemplateEngine.RenderAsync("/Views/Home/Rcl.cshtml"); // relative path to the root
Please note this may become slightly better in the future versions of our library.
Note:
- Please ensure that the views path is always unique among all the shared template projects.
Sample Applications
Please find the sample applications here
Support
If you find this helpful, consider supporting the development of this library by sponsoring one or more coffeeย ;) Thanks!
References:
Thanks to all the great articles and projects which helped to bring this library out!
- https://github.com/Andy9FromSpace/razor-renderer-core
- https://github.com/aspnet/Entropy/tree/master/samples/Mvc.RenderViewToString
- https://www.frakkingsweet.com/razor-template-rendering/
- https://github.com/veccsolutions/RenderRazorConsole
- https://emilol.com/razor-mailer/
- https://codeopinion.com/using-razor-in-a-console-application/