Razor.Templating.Core 1.5.0

There is a newer version of this package available.
See the version list below for details.
dotnet add package Razor.Templating.Core --version 1.5.0
NuGet\Install-Package Razor.Templating.Core -Version 1.5.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Razor.Templating.Core" Version="1.5.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Razor.Templating.Core --version 1.5.0
#r "nuget: Razor.Templating.Core, 1.5.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Razor.Templating.Core as a Cake Addin
#addin nuget:?package=Razor.Templating.Core&version=1.5.0

// Install Razor.Templating.Core as a Cake Tool
#tool nuget:?package=Razor.Templating.Core&version=1.5.0

Razor Templating

Build+Test Nuget Downloads

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
Console
Api
Mvc
Worker Service
WPF
WinForms

Applications

  • Email Templating
  • Report Generation & so on

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.5.0" />

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>"
};

var viewData = new Dictionary<string, object>();
viewData["Value1"] = "1";
viewData["Value2"] = "2";

var html = await RazorTemplateEngine.RenderAsync("/Views/ExampleView.cshtml", model, viewData);

Before applying this code, follow this article for working implementation: https://medium.com/@soundaranbu/render-razor-view-cshtml-to-string-in-net-core-7d125f32c79

Dependency Injection [Since v1.4.0]

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

// 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(); 
var html = await RazorTemplateEngine.RenderAsync("~/Views/ExampleViewServiceInjection.cshtml");

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

Sample Applications

Please find the sample applications here

Note:

  • Please ensure that the views path is always unique among all the shared template projects.
References:

Thanks to all the great articles and projects which helped to bring this library out!

Product Compatible and additional computed target framework versions.
.NET net5.0 is compatible.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp3.0 is compatible.  netcoreapp3.1 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (15)

Showing the top 5 NuGet packages that depend on Razor.Templating.Core:

Package Downloads
Sitko.Core.App.Web

Sitko.Core is a set of libraries to help build .NET Core applications fast

FenixAlliance.ACL.Dependencies

Application Component for the Alliance Business Suite.

Bnsights.Core

Package Description

Digizuite.Optimizely

The official integration between Digizuite DAM and Optimizely CMS.

FinancialModuleAuxiliary

Package Description

GitHub repositories (2)

Showing the top 2 popular GitHub repositories that depend on Razor.Templating.Core:

Repository Stars
sitkoru/Sitko.Core
Sitko.Core is a set of libraries to help build .NET Core applications fast
LANCommander/LANCommander
Version Downloads Last updated
2.0.0-rc.1 779 3/4/2024
1.9.0 255,132 8/25/2023
1.9.0-rc.2 64,860 2/25/2023
1.9.0-rc.1 90,434 11/13/2022
1.8.0 800,389 11/5/2022
1.8.0-rc.1 6,512 9/17/2022
1.7.1 451,248 7/2/2022
1.7.1-rc.1 14,107 2/20/2022
1.7.0 690,751 11/13/2021
1.7.0-preview.1 2,180 9/26/2021
1.6.1-rc.1 4,692 1/13/2022
1.6.0 412,304 9/26/2021
1.6.0-rc.2 6,856 5/14/2021
1.6.0-rc.1 626 5/13/2021
1.5.0 343,217 2/27/2021
1.4.0 92,103 12/5/2020
1.4.0-rc.1 625 11/19/2020
1.3.0 8,452 11/17/2020
1.2.1 30,824 9/21/2020
1.2.0 3,625 7/11/2020
1.1.2 2,405 4/13/2020
1.1.0 804 4/13/2020
1.0.1 874 4/3/2020
1.0.0 958 4/3/2020