YG.SendMail 2.0.0

YGSendMail

A simple email sending functionality that uses MailKit to connect, authenticate, build and send the emails

Installation

Include this package in the project file

Usage

// using DI registration:

builder.Services.AddYGSendEmail(new SendMailOptions()
{
     Host = config["YGSendEmail:Host"],
     Username = config["YGSendEmail:Username"],
     Password = config["YGSendEmail:Password"],
     Port = port,
     SecureSocketOption = sso
});

and inject ISendMail email and then in a function:

  var email = new EmailDTO
        {
            To = action.EmailRecipients,
            Subject = action.EmailSubject
                ?? _options.DefaultEmailSubject,
            Body = message,
            IsHtml = false
        };

    string result = await _email.SendAsync(email);

// Direct call:

//Warning! incorrect port or SecureSocketOptions could cause the instantiation to hang.
//It is best to test it first in a console program in debug mode

    using (ISendMail sm = new SendMail(host, port, MailKit.Security.SecureSocketOptions.Auto, username, pwd))   // use whatever SecureSocketOptions works for you
    {    
        string errMsg = sm.ErrorMsg;   
        EmailDTO eml = new EmailDTO()    
        {    
            To = new string[] { to },    
            Subject = subject,    
            Body = body,    
            SenderEmail = senderEmail,    
            SenderName = senderName    
        };    
        string result = await sm.SendAsync(eml);    
    }      

Attachments and LinkedResources can be added in eml object - see sample code in repo Attachments and LinkedResources can be filenames or filenames and byte[] contents

Warning!!!

⚠️ Do not call .Result or .Wait() on this API in UI apps. It could make SendAsync die silently!

Examples

Test project is provided in the solution of the source code to illustrate how instantiate and invoke the email sending functionality

Output:

The output is a string. If there is any error, the output will show the error message

Dependencies

MailKit MimeKit

Contributing

Any new ideas on how to enhance this class without adding much complexity, please adhere to SOLID principle

License

This project is licensed under the MIT License(LICENSE).