This is a simplified and complete rewrite of MailBody in .NET 6
Generate transactional emails such as forget password, order completed, etc.
Installation • How To Use • Showcases • Extensibility
Install with NuGet:
dotnet add package MailBody.Core
Use the MailBodyBuilder class to generate your email.
var html = new MailBodyBuilder()
.WithDefaultLayout()
.WithParagraph("Please confirm your email address by clicking the link below.")
.WithParagraph("We may need to send you critical information about our service and it is important that we have an accurate email address.")
.WithButton("https://example.com/", "Confirm Email Address")
.WithParagraph("— [Insert company name here]")
.ToHtml();Use the MailBlockBuilder class to generate HTML. This can be useful for nested content scenarios; for example, you need to place an image inside an a tag.
var image = new MailBlockBuilder()
.WithImage("sample.png", "sample")
.ToHtml();
var html = new MailBodyBuilder()
.WithDefaultLayout()
.WithParagraph("Please click on the image to download your item.")
.WithLink(image, "www.example.com/download");
// or
var html = new MailBodyBuilder()
.WithDefaultLayout()
.WithParagraph("Please click on the image to download your item.")
.WithLink(builder => builder.WithImage("sample.png", "sample"), "www.example.com/download"); The picture below is a example of generated email using default layout.
You can add your element by implementing IMailElement and passing it to the builder using WithElement() method. The example below demonstrates how to add the horizontal element.
// Implement the IMailElement
public class HorizontalLineElement : IMailElement
{
public string ToHtml()
{
return "<hr>";
}
}
// Pass your element to the builder
var html = new MailBodyBuilder()
.WithParagraph("Below there is a horizontal line.")
.WithElement(new HorizontalLineElement())
.ToHtml();You can add your custom layout by implementing IMailLayout and passing it to the builder using WithLayout() method.
// Implement the IMailElement
public class CustomLayout : IMailLayout
{
public string ToHtml(string content)
{
return $@"<!DOCTYPE html>
<html>
<head>
<title>Custom Layout</title>
</head>
<body>
{content}
</body>
</html>"
}
}
// Pass your layout to the builder
var html = new MailBodyBuilder()
.WithLayout(new CustomLayout())
.WithParagraph("Below there is a horizontal line.")
.ToHtml();