53

I am creating an email engine in mvc3 and I am trying to use razor views as email templates. I heard this is possible but I have not yet found any information about it.

1

5 Answers 5

63

You can use http://razorengine.codeplex.com/ to achieve this. It allows you to use razor outside of mvc.

string Email = "Hello @Model.Name! Welcome to Razor!";
string EmailBody = Razor.Parse(Email, new { Name = "World" });

It's simple to implement and it's available on http://nuget.codeplex.com/ for easy integration into your projects.

7
  • I will definetely check this one out @BuildStarted. One question though : So If I understand correctly this is not build into razor by default?
    – sTodorov
    Dec 7, 2010 at 8:52
  • looks great. One more question though: Can you still use *.cshtml "pages" as the templates?
    – sTodorov
    Dec 7, 2010 at 9:24
  • No, it's not built into razor by default. Good question. While I'm sure it can process cshtml pages via razor it doesn't support it out of the box in that you'd have to add an additional template to support features such as @Html functionality. It might be worth requesting at the codeplex page for that support. Though MVC has it's own razor parser that's actually separate from razor itself so I'm not sure if it can be done that easily. Dec 7, 2010 at 15:00
  • Thanks for that @BuildStarted - very useful utility/library to know about for those times when email processing is done in a Windows Service, for instance.
    – HenningK
    Nov 18, 2011 at 9:43
  • 1
    Where do you put the cshtml template? To the resources? Jun 29, 2014 at 21:06
27

You CAN use a template file to serve as a razor email body template. You can use whichever extension you choose because you can load a file as text in .Net. Let's use the following example for the template:

Hello @Model.Name,

Welcome to @Model.SiteName!

Regards,
Site Admins

Save that file as something like "WelcomeMessage.cshtml", "WelcomeMessage.template", etc. Select the file in Solution Explorer and in the Properties window, select "Copy to Output Directory" and choose "Copy Always". The only down point is that this template has to accompany the application and doesn't compile as a class.

Now we want to parse it as a string to assign to a mail message body. Razor will take the template and a model class, parse them, and then return a string with the necessary values. In your application you will need to add the RazorEngine package which can be found with NuGet. Here's a short code example to illustrate the usage:

using System.IO;
using RazorEngine;

// ...
MyModel model = new MyModel { Name = "User", SiteName = "Example.com" };
string template = File.OpenText("WelcomeMessage.template").ReadToEnd();
string message = Razor.Parse(template, model);

It's similar to the other answers but shows a quick way to load the template from a text file.

0
13

You should perhaps consider MvcMailer. RazorEngine is (very) good if you aren't already using MVC (I've used it successfully in a webforms context), but if you have MVC you may as well take advantage of it.

(via Hanselmen's NuGet package of the week 2)

1
  • 3
    Note that MvcMailer requires a HttpContext, which is why RazorEngine is a good choice for non-MVC users, or if you are planning to send emails from a background task.
    – Dunc
    May 7, 2015 at 14:30
4

You can also use Essential Mail: Razor package from NuGet. It is build over RazorEngine and provides simple interface for email rendering.

Email message template looks something like

@inherits Essential.Templating.Razor.Email.EmailTemplate
@using System.Net;
@{
    From = new MailAddress("[email protected]");
    Subject = "Email Subject";
}
@section Html 
{
   <html>
      <head>
          <title>Example</title>
      </head>
      <body>
          <h1>HTML part of the email</h1>
      </body>
   </html>
}
@section Text 
{
    Text part of the email.
}

Read more on GitHub: https://github.com/smolyakoff/essential-templating/wiki/Email-Template-with-Razor

0

Mailzor

Linked to what @thiagoleite mentioned, I took Kazi Manzur Rashid's idea (with permission) and extended in to be more friendly for how I wanted to use it.

So check out the github project 'mailzor'

It's also up on Nuget.org/packages/mailzor

1
  • In case it's necessary the disclosure note is it's something I'm maintaining/working on. Dec 20, 2012 at 4:35

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.