SmtpMail.ReturnPath Property


Gets or sets a MailAddress of the delivery notification report address.

[Visual Basic]
Public Property ReturnPath As MailAddress
[C#]
public MailAddress ReturnPath {get; set;}
[C++]
public: __property MailAddress^ get_ReturnPath();
public: __property void set_ReturnPath(MailAddress^);
[JScript]
public function get ReturnPath() : MailAddress;
public function set ReturnPath(MailAddress);

Property Value

A MailAddress instance of the delivery report address.

Remarks

From

This property indicates the original email sender. This is what you see as the "FROM" in most mail clients.

Reply-To

This property indicates the reply address. Basically, when the user clicks "reply" in mail client, the Reply-To value should be used as the recpient address of the replied email. If you don't set this property, the Reply address is same as From address.

Sender

This property indicates the who submit/send the email. When the user received the email, the email client displays:
From: "sender address" on behalf of "from address".
If you don't set this property, the Sender address is same as From address. Sender property is common used by mail listing provider. This property also takes effect to DKIM/DomainKeys signature, if Sender is different with From address, then you should sign DKIM/DomainKeys based on Sender domain instead of From address domain.

Return-Path

This property indicates the delivery notification report address. If you don't set this property, the Return-Path address is same as From address. This property also takes effect to SPF record, if Return-Path is different with From address, then remote SMTP server checkes SPF record of Return-Path instead of From address.

Example

[Visual Basic, C#] To get the full samples of EASendMail, please refer to Samples section.

[VB - Send Email - From, Reply-To, Return-Path, Sender]

Imports EASendMail

Sub SendMail()

    Try
        Dim oMail As SmtpMail = New SmtpMail("TryIt")
        ' Set ReturnPath 
        ' then the failure-report will be sent to this address instead of From
        oMail.ReturnPath = "report@adminsystem.com"
        
        ' Set ReplyTo, the email will be replied to this address instead of From
        oMail.ReplyTo = "reply@adminsystem.com"
    
        ' Set Sender, 
        ' If the user received the email, the email client will display:
        ' "sender@emailarchitect.net" on behalf of "from@adminsystem.com".
        oMail.Sender = "sender@emailarchitect.net"

        ' oMail.From = New MailAddress("From Tester", "from@adminsystem.com")
        ' oMail.From = New MailAddress("From Tester ")

        oMail.From = New MailAddress("from@adminsystem.com")
        oMail.To.Add(New MailAddress("to@adminsystem.com"))
        
        oMail.Subject = "test subject"
        oMail.TextBody = "test body"
                
        Dim oServer As SmtpServer = New SmtpServer("myserveraddress")
        ' SMTP user authentication
        oServer.User = "myusername"
        oServer.Password = "mypassword"

        ' 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

        Dim oSmtp As SmtpClient = New SmtpClient()
        oSmtp.SendMail(oServer, oMail)
        
        Console.WriteLine("message was sent")
    
    Catch exp As System.Exception
        Console.WriteLine("Exception: {0}", exp.Message)
    End Try

End Sub


[C# - Send Email - From, Reply-To, Return-Path, Sender] using System; using EASendMail; void SendMail() { try { SmtpMail oMail = new SmtpMail("TryIt"); // Set ReturnPath // then the failure-report will be sent to this address instead of From oMail.ReturnPath = "report@adminsystem.com"; // Set ReplyTo, the email will be replied to this address instead of From oMail.ReplyTo = "reply@adminsystem.com"; // Set Sender, // If the user received the email, the email client will display: // "sender@emailarchitect.net" on behalf of "from@adminsystem.com". oMail.Sender = "sender@emailarchitect.net"; // oMail.From = New MailAddress("From Tester", "from@adminsystem.com"); // oMail.From = New MailAddress("From Tester "); oMail.From = new MailAddress("from@adminsystem.com"); oMail.To.Add(new MailAddress("to@adminsystem.com")); oMail.Subject = "test subject"; oMail.TextBody = "test body"; SmtpServer oServer = new SmtpServer("myserveraddress"); // SMTP user authentication oServer.User = "myusername"; oServer.Password = "mypassword"; // 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("message was sent"); } catch(Exception exp) { Console.WriteLine("Exception: {0}", exp.Message); } }

See Also

From, ReplyTo, Sender and Return-Path
SmtpMail.ReplyTo Property
SmtpMail.Sender Property
SmtpMail.From Property