Soenneker.Extensions.Dtos.Email 3.0.11

Soenneker.Extensions.Dtos.Email

A collection of helpful EmailDto extension methods

📧 Features

• Converts a well-defined EmailDto into a MimeKit MimeMessage
• Supports both html and plain formats
• Adds To, Cc, Bcc, and Reply-To addresses
• Automatically attaches files via EmailAttachmentDto
• Sets headers for High and Low priority emails
• Logs malformed recipients using ILogger

🧪 Validation

The extension validates:

• Required fields: To, Subject, and Body
• Non-null, non-whitespace addresses
• Optionally logs issues rather than throwing for individual recipient fields

Installation

dotnet add package Soenneker.Extensions.Dtos.Email

🔧 Usage

var mimeMessage = emailDto.ToMimeMessage(logger);

📁 Example EmailDto

var dto = new EmailDto
{
    To = new List<string> { "to@example.com" },
    Cc = new List<string> { "cc@example.com" },
    Bcc = new List<string> { "bcc@example.com" },
    ReplyTo = "reply@example.com",
    Name = "Sender Name",
    Address = "sender@example.com",
    Subject = "Test Subject",
    Body = "<p>This is a test email.</p>",
    Format = EmailFormat.Html,
    Priority = EmailPriority.High,
    Attachments = new List<EmailAttachmentDto>
    {
        new EmailAttachmentDto
        {
            FileName = "test.txt",
            MimeType = "text/plain",
            Data = Encoding.UTF8.GetBytes("Sample attachment content")
        }
    }
};