This is a simple library you can use to write e-mail templates in Razor syntax. That means you write raw HTML,
but elevated with C# — you get @foreach, @switch, and so on, and you get a strongly-typed model for custom data.
In NuGet, reference either the TRENZ.Lib.RazorMail.SystemNet or the TRENZ.Lib.RazorMail.MailKit package, depending
on which MailSender backend you prefer. MailKit is more modern and powerful,
but System.Net.Mail comes built into .NET. There is no need to reference TRENZ.Lib.RazorMail directly.
Via dotnet:
dotnet add package TRENZ.Lib.RazorMail.SystemNet…or:
dotnet add package TRENZ.Lib.RazorMail.MailKitA simple template looks like so:
@using TRENZ.Lib.RazorMail.SampleWebApi.Models
@inherits TRENZ.Lib.RazorMail.Core.MailTemplateBase<SampleModel>
@{
Subject = "Greetings!";
}
<!DOCTYPE html>
<html lang="en">
<head>
<title></title>
</head>
<body>
<h1>@Model.Salutation!</h1>
</body>
</html>Where SampleModel is:
public record SampleModel(string Salutation);Notice that:
- we're passing
SampleModelas our model type. It has a propertySalutation, so we can then do@Model.Salutationto get its value. - we can set the
Subjectproperty, which becomes the e-mail subject.
Inheriting from TRENZ.Lib.RazorMail.Core.MailTemplateBase<T> also gives us the convenience methods AttachFile() and
InlineFile(). These differ only in whether an attachment is intended for download, or for inline display.
For example, to show an image inline, you simply do:
<img src="@InlineFile("My Company Logo.png")" />That's it. This attaches the image as a file, then references it using cid format1.
Because the image is attached, this also doesn't require your users to enable
loading external images, which some mail clients restricts for privacy reasons.
Or, to attach a file:
@{
AttachFile("Invoice.pdf", someByteArray);
}(Because file attachments don't relate to the body, you probably want to put this near the Subject.)
Depending on which NuGet package you've picked above, you get a backend for sending either via the classic
System.Net.Mail, or via MailKit/MimeKit. In the code below, replace YourMailSender with either SystemNetMailSender or
MailKitMailSender.
To wrap it all up:
const string view = "Sample";
// this is your model. If you're sending to multiple people, you may want to customize this per person.
var model = new SampleModel(request.Salutation);
// this renders your view (your e-mail template), with the above model as an argument).
var renderedMail = await EmailRenderer.RenderAsync(view, model);
// this wraps the rendered HTML and passes it to a service that handles sending.
// You need someone to send from, and one or more recipients.
var mail = new YourMailSender(from: request.From,
to: new[] { (MailAddress)request.To }.ToList(),
renderedMail);
// this actually sends the e-mail
await mail.SendAsync(SmtpAccount);Footnotes
-
Each attachment becomes part of a MIME multipart message, and is identified by its Content-ID. To refer to that part, RazorMail then uses the
cid:(Content-ID)URI scheme. ↩