Skip to content

robinvanderknaap/RazorMailMessage

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

RazorMailMessage

RazorMailMessage enables you to create .NET MailMessage objects based on Razor templates without a depedency on ASP.NET MVC. Support for layouts, sections, viewbag and multi-part messages.

NuGet

Install-Package RazorMailMessage

License

All source code is licensed under the MIT License

Usage

Messages are created using the RazorMailMessage factory.

var razorMailMessageFactory = new RazorMailMessageFactory();
var mailMessage = razorMailMessageFactory.Create("MailTemplates.Template.cshtml", new { Name = "Robin" });

The default implementation of RazorMailMessage uses a template resolver based on embedded resources, so all templates need to have build action set to embedded resource.

Use the create method on the factory to create a mailmessage. The first parameter is the template name, this is the name including namespace and file extension. The second parameter is the model which can be used inside the template.

When templates are contained in another assembly, you have to configure the default template resolver

var templateResolver = new DefaultTemplateResolver("NameOfAssembly", "MailTemplates");
var razorMailMessageFactory = new RazorMailMessageFactory(templateResolver);
var mailMessage = razorMailMessageFactory.Create("Template.cshtml", new { Name = "Robin" });

The constructor of the default template resolver takes an assemblyname and a namespace as parameters. This way we have cleaner template names when creating a mailmessage.

Layouts and sections

Layouts are resolved like regular templates. The layout is specified within the template, make sure to include the namespace and file extension in the layoutname.

@{
	Layout = "Layouts.Layout.cshtml";
}

Sections are also supported, and work the same way as in ASP.NET MVC razor templates.

Template resolver

The default template resolver uses embedded resources to resolve templates. It's possible to use a custom template resolver. This allows for other ways of resolving templates, for example from the database or from the filesystem. A custom resolver should implement the ITemplateResolver interface:

public interface ITemplateResolver
{
    string ResolveTemplate(string templateName, bool isPlainText);
    string ResolveLayout(string layoutName);
}

The resolver should be specified when instatiating the RazorMessageFactory

var razorMailMessageFactory = new RazorMailMessageFactory
(
    new CustomTemplateResolver()
);

Baseclass

The constructor of the RazorMailMessage factory can also take an alternative baseclass for the templates in the constructor. The baseclass should inherit from TemplateBase

public class CustomTemplateBase<T> : TemplateBase<T>
{

}

To enable dependency injection in the baseclass, include a Func<Type, Object> method in the constructor. Which will be called for every constructor parameter of the base class. This would look something like this:

var razorMailMessageFactory = new RazorMailMessageFactory
(
	new DefaultTemplateResolver(), 
	typeof(CustomTemplateBase<>), 
	new Func<Type, object>(x => _container.Resolve(x))
);

This way a dependency injection container can be used to resolve the constructor arguments of a custom template base.

ViewBag

ViewBag is supported. You can specify a ViewBag in the create method of the RazorMailMessageFactory.

dynamic viewBag = new DynamicViewBag();
viewBag.Name = "Robin";

var mailMessage = razorMailMessageFactory.Create("TestTemplate", model, viewBag);

Caching

By default templates and layouts are resolved only once and cached in memory. The caching mechanism can be overriden by a class implementing ITemplateCache

public interface ITemplateCache
{
    string Get(string templateCacheName);
    void Add(string templateCacheName, string template);
}

The custom template cache can be set in the constructor of the RazorMailMessageFactory

Examples

In the source code you will find an example project. Which is a console application showcasing the possibilties of the library.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published