SmtpMail.DeliveryNotification Property


Gets or sets the delivery notifications for this e-mail message.

[Visual Basic]
Public Property DeliveryNotification As DeliveryNotificationOptions
[C#]
public DeliveryNotificationOptions DeliveryNotification {get; set;}
[C++]
public: __property DeliveryNotificationOptions^ get_DeliveryNotification();
public: __property void set_DeliveryNotification(DeliveryNotificationOptions^);
[JScript]
public function get DeliveryNotification() : DeliveryNotificationOptions;
public function set DeliveryNotification(DeliveryNotificationOptions);

Property Value

Any combination of DeliveryNotificationOptions values.

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.Collections.Generic; 
using System.Text; 

// Add EASendMail namespace
using EASendMail; 

namespace mysendemail 
{ 
    class Program 
    { 
        static void Main(string[] args) 
        { 
            SmtpMail oMail = new SmtpMail("TryIt"); 
            SmtpClient oSmtp = new SmtpClient(); 

            // 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"; 

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

            // User and password for ESMTP authentication, if your server doesn't require
            // User authentication, please remove the following codes.
            oServer.User = "test@emailarchitect.net"; 
            oServer.Password = "testpassword"; 

            // If your smtp server requires SSL connection, please add this line
            // oServer.ConnectType = SmtpConnectType.ConnectSSLAuto;

            // Request read receipt
            oMail.ReadReceipt = true; 

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

            try 
            { 
                Console.WriteLine("start to send email ..."); 
                oSmtp.SendMail(oServer, oMail); 
                Console.WriteLine("email was sent successfully!"); 
            } 
            catch (Exception ep) 
            { 
                Console.WriteLine("failed to send email with the following error:"); 
                Console.WriteLine(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

' Add EASendMail namespace
Imports EASendMail 

Module Module1 
    Sub Main() 
        Dim oMail As New SmtpMail("TryIt") 
        Dim oSmtp As New SmtpClient() 

        ' 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, if your server doesn't require
        ' User authentication, please remove the following codes.
        oServer.User = "test@emailarchitect.net" 
        oServer.Password = "testpassword" 

        ' If your SMTP server requires SSL connection, please add this line
        ' oServer.ConnectType = SmtpConnectType.ConnectSSLAuto

        ' Request read receipt
        oMail.ReadReceipt = True 

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

        Try 

            Console.WriteLine("start to send email ...") 
            oSmtp.SendMail(oServer, oMail) 
            Console.WriteLine("email was sent successfully!") 

        Catch ep As Exception 

            Console.WriteLine("failed to send email with the following error:") 
            Console.WriteLine(ep.Message) 
        End Try 

    End Sub 
End Module 
    

See Also

Process Bounced Email (Non-Delivery Report) and Email Tracking