DeliveryNotificationOptions Enumeration

Specifies the delivery notification options for e-mail.

[Visual Basic]
Public Enum DeliveryNotificationOptions

[C#]
public enum DeliveryNotificationOptions

[C++]
_value public enum DeliveryNotificationOptions

[JScript]
public enum DeliveryNotificationOptions

Members

Members name	Description
None	Using the SMTP server default notification, most SMTP server only sends the notification when the email cound't be delivered to recipient.
OnSuccess	Notify if the delivery is successful.
OnFailure	Notify if the delivery is unsuccessful.
Delay	Notify if the delivery is delayed.
Never	Never notify.

Remarks

If you don't set this property, SMTP server only sends the failure report back to the sender. Because not every SMTP server support above options, if you don't have special requirement, please set it to DeliveryNotificationOptions.None (default). You always get Failure Report from SMTP server even you set this property to DeliveryNotificationOptions.None.

Import Notice: Not every SMTP server support Delivery Receipt. Only the SMTP server that supports DSN extension command accepts Delivery Receipient request, otherwise you will get error when you are sending email.

The following example codes demonstrate how to request read receipt and delivery receipt:

[C#]
// The following example codes demonstrate requesting read receipt and delivery receipt
// To get full sample projects, please download and install EASendMail on your machine.
// To run it correctly, please change SMTP server, user, password, sender, recipient value to yours

using System;  
using System.Text; 
using EASendMail; 

void SendMail()
{
    try
    {
        SmtpMail oMail = new SmtpMail("TryIt");
        // Set sender email address, please change it to yours
        oMail.From = "test@emailarchitect.net";
        // Set recipient email address, please change it to yours
        oMail.To = "support@emailarchitect.net";

        // Set email subject
        oMail.Subject = "test email from c# project";
        // Set email body
        oMail.TextBody = "this is a test email sent from c# project, do not reply";

        // Request read receipt
        oMail.ReadReceipt = true;

        // Request both failure and success report
        oMail.DeliveryNotification = DeliveryNotificationOptions.OnFailure |
            DeliveryNotificationOptions.OnSuccess;

        // Your SMTP server address
        SmtpServer oServer = new SmtpServer("smtp.emailarchitect.net");

        // User and password for ESMTP authentication
        oServer.User = "test@emailarchitect.net";
        oServer.Password = "testpassword";

        // Most mordern SMTP servers require SSL/TLS connection now.
        // ConnectTryTLS means if server supports SSL/TLS, SSL/TLS will be used automatically.
        oServer.ConnectType = SmtpConnectType.ConnectTryTLS;

        SmtpClient oSmtp = new SmtpClient();
        oSmtp.SendMail(oServer, oMail);

        Console.WriteLine("email was sent successfully!");
    }
    catch (Exception ep)
    {
        Console.WriteLine("failed to send email {0}", ep.Message);
    }
}


[VB]
' The following example codes demonstrate requesting read receipt and delivery receipt
' To get full sample projects, please download and install EASendMail on your machine.
' To run it correctly, please change SMTP server, user, password, sender, recipient value to yours

Imports EASendMail 

Sub SendMail()

    Try
        Dim oMail As New SmtpMail("TryIt")

        ' Set sender email address, please change it to yours
        oMail.From = "test@emailarchitect.net"
        ' Set recipient email address, please change it to yours
        oMail.To = "support@emailarchitect.net"

        ' Set email subject
        oMail.Subject = "test email from VB.NET project"
        ' Set email body
        oMail.TextBody = "this is a test email sent from VB.NET project, do not reply"

        ' Your SMTP server address
        Dim oServer As New SmtpServer("smtp.emailarchitect.net")

        ' User and password for ESMTP authentication
        oServer.User = "test@emailarchitect.net"
        oServer.Password = "testpassword"

        ' Most mordern SMTP servers require SSL/TLS connection now.
        ' ConnectTryTLS means if server supports SSL/TLS, SSL/TLS will be used automatically.
        oServer.ConnectType = SmtpConnectType.ConnectTryTLS

        ' Request read receipt
        oMail.ReadReceipt = True

        ' Request both failure and success report
        oMail.DeliveryNotification = DeliveryNotificationOptions.OnFailure Or
        DeliveryNotificationOptions.OnSuccess

        Dim oSmtp As New SmtpClient()
        oSmtp.SendMail(oServer, oMail)

        Console.WriteLine("email was sent successfully!")
    Catch ep As Exception
        Console.WriteLine("failed to send email {0}", ep.Message)
    End Try

End Sub