SmtpMail.ReadReceipt Property


Sets the read receipt request in the email.

[Visual Basic]
Public Property ReadReceipt As Boolean
[C#]
public bool ReadReceipt {get; set;}
[C++]
public: __property bool get_ReadReceipt();
public: __property void set_ReadReceipt(bool);
[JScript]
public function get ReadReceipt() : bool;
public function set ReadReceipt(bool);

If the value is true, a read receipt request will be added to the email message.

Read Receipt

Some e-mail applications, such as Microsoft Office Outlook, employ a read-receipt tracking mechanism. A sender selects the receipt request option prior to sending the message. Upon opening the email, each recipient has the option of notifying the sender that the message was opened and read.

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