Jasmin.SimpleSMTP 2.1.11

Simple (SMTP - Simple Mail Transfer Protocol)

Mission Statement:

• Hide or Eliminate the complexity of the SMTP Protocol

License

MIT

Version Features:

1. smtpSetting.Host.SecureSocketOption = SecureSocketOption.StartTlsWhenAvailable; // As the default
2. smtpSetting.Host.Authenticate = true; // As the default

Previous version assumed the above while this version exposes the properties

Usage/C# Examples

This main method contains the basic steps in order to send an email

1. Know what you want to mail and to whom
2. know the SMTP server's configuration that you will use to send the email
3. Send the email using this SendEmailAsync method

using SimpleSmtp.Class.Models.MailRequests;
using SimpleSmtp.Class.Models.SmtpSettings;
using SimpleSmtp.Class.Services.Foundations;
using SimpleSMTP.SecureSocketOptions;
private static void Main( string[] args )
{
	var eMailInformation = PrepareEmail();
	var smtpInformation = PrepareSmtpSetting();

	var emailService = new EmailService(smtpInformation);
	emailService.SendEmailAsync(eMailInformation).Wait();
}

This method provides is an example of how to set typical Email information

This method provides examples of specifying such items as:

1. Sender Name (pretty name)
2. Sender Email Address
3. Subject
4. Body
5. To (n)
6. Cc (n)
7. Bcc (n)
8. attachment (n)

private static MailRequest PrepareEmail()
{
	// All Values as sample only and must be changed to what you desire
	var mailRequest = new MailRequest();
	
	mailRequest.Sender.DisplayName = "Sue Smith";
	mailRequest.Sender.Address = "SueSmith@xyz.com";
	mailRequest.Subject = "Email Subject";
	mailRequest.Body = "This is the body of the email";
		
	//Decide how you want to present the email (all combinations can be used together or separately)
	mailRequest.AddToRecipient("ToSmith@xyz.com", "To Smith");  // Repeat as often as needed with new "To" Recipients
	mailRequest.AddCcRecipient("CcSmith@xyz.com", "Cc Smith");  // Repeat as often as needed with new "CC" Recipients
	mailRequest.AddBCcRecipient("BlindSmith@xyz.com", "Blind Smith");  // Repeat as often as needed with new "BCC" Recipients
		
	mailRequest.AddFile(
		fullPathAndName: $@"\\YourFilePath\YourFileName,WithExtension",
		nameWithExtension: $"NameItThisInEmail.WithThisExtension");	// Repeat for as many files as you would like attached to the email

    return emailRequest;
}

This method is for you to set your desired SMTP Setting

This is a sample project so consider dependency inversion in your production application.

private static SmtpSetting PrepareSmtpSetting()
{
    // All Values as sample only (Adjust to your preferred SMTP server)
    var smtp = new SmtpSetting();
    
    smtp.Host.Name = "smtp.xyz.com";
    smtp.Host.Port = 587;	// This is the default
    smtp.Host.SecureSocketOption = SecureSocketOption.StartTlsWhenAvailable;	// This is the default
    smtp.Host.Authenticate = true; // This is the default
		
    // You must provide below if Server Authenticates
    smtp.Host.UserName = "appid@xyz.com";
    smtp.Host.Password = "appid!Password1";
		
    return smtp;
}

Feedback

If you have any feedback, please reach out to us at aspado

Authors

• @aspado