SMTP Component for C#, VB.NET, ASP.NET, JScript.NET VC.NET dotnet Send Email SSL SMIME TLS Class

SmtpMail Class

Provides properties and methods for constructing an e-mail message.

System.Object
EASendMail.SmtpMail

[Visual Basic]
Public Class SmtpMail

[C#]
public class SmtpMail

[C++]
public __gc class SmtpMail

[JScript]
public class SmtpMail

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Public Constructors

SmtpMail Constructor

Initializes a new instance of the SmtpMail class.

Public Properties

AutoTextBody	Specifies the e-mail generates alternative text body for html body automatically.
Bcc	Gets or sets a AddressCollection of e-mail addresses that receive a blind carbon copy (BCC) of the e-mail message.
Cc	Gets or sets a AddressCollection of e-mail addresses that receive a carbon copy (CC) of the e-mail message.
Charset	Gets or sets the charset of the e-mail message.
Date	Gets or sets the date time of the e-mail message.
DeliveryNotification	Gets or sets the delivery notifications for this e-mail message.
EncodedContent	Gets the encoded email content.
EncryptionAlgorithm	Gets or sets the algorithm for email encryption.
From	Gets or sets the e-mail address of the sender.
HeaderEncoding	Gets or sets the encoding for subject and friendly name in From, To, Cc.
Headers	Gets the HeaderCollection for headers of the e-mail message.
HtmlBody	Gets or sets the html body of the e-mail message.
Mailer	Gets or sets the "X-Mailer" of the e-mail message.
MessageID	Gets the Message-ID of the e-mail message.
MimeParts	Gets the MimePartCollection of the e-mail message.
Priority	Gets or sets the priority of the e-mail message.
ReadReceipt	Sets the read receipt request in the email.
Recipients	Gets a AddressCollection for all e-mail receivers (To, Cc, Bcc).
ReplyTo	Gets or sets the e-mail address of the reply address.
ReturnPath	Gets or sets the e-mail address of the delivery report address.
Subject	Gets or sets the subject of the e-mail message.
TextBody	Gets or sets the text body of the e-mail message.
To	Gets or sets a AddressCollection of recipient e-mail addresses.
TransferEncoding	Gets or sets encoding for the body text of the e-mail message.

Public Methods

AddAttachment	Attaches a file to the e-mail message.
ClearAttachments	Clears all the file attachments of the e-mail message.
LoadMessage	Loads a RFC822 message ( *.eml) file to current SmtpMail instance.
ImportHtml	Imports html source from string to html body of the e-mail message.
ImportHtmlBody	Imports html source from file or remote website to html body of the e-mail message.
ImportTextBody	Imports text source from file or remote website to text body of the e-mail message.
RemoveAttachment	Removes file attachment from the e-mail message by file name.
Reset	Resets the From, To, Cc, Bcc, Subject, TextBody, HtmlBody, Message-ID and Date of the e-mail message.
SaveAs	Saves the e-mail message to a file (*.eml file).

Example

[Visual Basic, C#, C++, JScript.NET] The following example demonstrates how to send email with EASendMail SMTP Component, but it doesn't demonstrates the events usage. To get the full samples of EASendMail, please refer to Samples section.

[Visual Basic]
Imports EASendMail

Public Sub SendMail( sFrom As String, _ 
    sTo As String, _ 
    sCc As String, _  
    sServer As String, _
    sUserName As String, _
    sPassword As String, _
    sSubject As String, _
    sBodyText As String, _
    bSSLConnection As Boolean )

    Dim oMail As SmtpMail = New SmtpMail("TryIt")
    Dim oSmtp As SmtpClient = New SmtpClient
    'To generate a log file for SMTP transaction, please use
    'oSmtp.LogFileName = "c:\smtp.log"

    Dim errStr As String = ""

    Try
 	'From is a MailAddress object, in c#, it supports implicit converting from string.
	'The syntax is like this: "test@adminsystem.com" or "Tester<test@adminsystem.com>"
				
	'The example code without implicit converting
	' oMail.From = New MailAddress( "Tester", "test@adminsystem.com" )
	' oMail.From = New MailAddress( "Tester<test@adminsystem.com>" )
	' oMail.From = New MailAddress( "test@adminsystem.com" )
	    
	'To, Cc and Bcc is a AddressCollection object, in C#, it supports implicit converting from string.
	' multiple address are separated with (,;)
	' The syntax is like this: "test@adminsystem.com, test1@adminsystem.com"

	'The example code without implicit converting
	' oMail.To = New AddressCollection( "test1@adminsystem.com, test2@adminsystem.com" )
	' oMail.To = New AddressCollection( "Tester1<test@adminsystem.com>, Tester2<test2@adminsystem.com>")			
	' You can add more recipient by Add method
	' oMail.To.Add( New MailAddress( "tester", "test@adminsystem.com"))
	   
        oMail.From = New MailAddress( sFrom )
        oMail.To = New AddressCollection(sTo)
        oMail.Cc = New AddressCollection(sCc)
        oMail.Subject = sSubject
        oMail.TextBody = sBodyText
        'If the sBodyText contains the html tag, please use
       'oMail.HtmlBody = sBodyText
       'Add attachment 
       'oMail.AddAttachment( "c:\test.gif" )
       
        Dim oServer As SmtpServer = New SmtpServer(sServer)
        
        If sUserName.Length > 0 And sPassword.Length > 0 Then
            oServer.User = sUserName
            oServer.Password = sPassword
        End If

        If (bSSLConnection) Then
            oServer.ConnectType = SmtpConnectType.ConnectSSLAuto
        End If

        oSmtp.SendMail(oServer, oMail)
        MessageBox.Show(String.Format("The message was sent to {0} successfully!", _
oSmtp.CurrentSmtpServer.Server))

    Catch exp As SmtpTerminatedException
        errStr = exp.Message
    Catch exp As SmtpServerException
        errStr = String.Format("Exception: Server Respond: {0}", exp.ErrorMessage)
    Catch exp As System.Net.Sockets.SocketException
        errStr = String.Format("Exception: Networking Error: {0} {1}", exp.ErrorCode, exp.Message)
    Catch exp As System.ComponentModel.Win32Exception
        errStr = String.Format("Exception: System Error: {0} {1}", exp.ErrorCode, exp.Message)
    Catch exp As System.Exception
        errStr = String.Format("Exception: Common: {0}", exp.Message)
    End Try
    If errStr.Length > 0 Then
        MessageBox.Show(errStr)
    End If
End Sub

[C#]
using System;
using System.Collections;
using EASendMail;

public void SendMail( string sFrom, 
    string sTo, 
    string sCc, 
    string sServer,
    string sUserName,
    string sPassword,
    string sSubject,
    string sBodyText,
    bool bSSLConnection )
{
    SmtpMail oMail = new SmtpMail("TryIt");
    SmtpClient oSmtp = new SmtpClient();
    //To generate a log file for SMTP transaction, please use
    //oSmtp.LogFileName = "c:\\smtp.log";
    string err = "";

    try
    {
 	//From is a MailAddress object, in c#, it supports implicit converting from string.
	//The syntax is like this: "test@adminsystem.com" or "Tester<test@adminsystem.com>"
				
	//The example code without implicit converting
	// oMail.From = new MailAddress( "Tester", "test@adminsystem.com" );
	// oMail.From = new MailAddress( "Tester<test@adminsystem.com>" );
	// oMail.From = new MailAddress( "test@adminsystem.com" );
	    
	//To, Cc and Bcc is a AddressCollection object, in C#, it supports implicit converting from string.
	// multiple address are separated with (,;)
	//The syntax is like this: "test@adminsystem.com, test1@adminsystem.com"

	//The example code without implicit converting
	// oMail.To = new AddressCollection( "test1@adminsystem.com, test2@adminsystem.com" );
	// oMail.To = new AddressCollection( "Tester1<test@adminsystem.com>, Tester2<test2@adminsystem.com>");			
    //You can add more recipient by Add method
	// oMail.To.Add( new MailAddress( "tester", "test@adminsystem.com"));
	   
        oMail.From = sFrom;
        oMail.To = sTo;
        oMail.Cc = sCc;
        oMail.Subject = sSubject;
        oMail.TextBody = sBodyText;
        //If the sBodyText contains the html tag, please use
        //oMail.HtmlBody = sBodyText;
        //Add attachment 
        //oMail.AddAttachment( "c:\\test.gif" );
        
        SmtpServer oServer = new SmtpServer( sServer );

        if( sUserName.Length != 0 && sPassword.Length != 0 )
        {
            oServer.User = sUserName;
            oServer.Password = sPassword;
        }
       
        if( bSSLConnection )
            oServer.ConnectType = SmtpConnectType.ConnectSSLAuto;

        oSmtp.SendMail( oServer, oMail  );
        
        MessageBox.Show( String.Format( "The message was sent to {0} successfully!", 
            oSmtp.CurrentSmtpServer.Server ));

    }
    catch( SmtpTerminatedException exp )
    {
        err = exp.Message;
    }
    catch( SmtpServerException exp )
    {
        err = String.Format( "Exception: Server Respond: {0}", exp.ErrorMessage );
    }
    catch( System.Net.Sockets.SocketException exp )
    {
        err = String.Format( "Exception: Networking Error: {0} {1}", exp.ErrorCode, exp.Message );
    }
    catch( System.ComponentModel.Win32Exception exp )
    {
        err = String.Format( "Exception: System Error: {0} {1}", exp.ErrorCode, exp.Message );          
    }
    catch( System.Exception exp )
    {
        err = String.Format( "Exception: Common: {0}", exp.Message );           
    }
    
    if( err.Length > 0  )
    {
        MessageBox.Show( err );
    }
}

[C++]
using namespace System;
using namespace System::Collections;
using namespace EASendMail; 

System::Void SendMail( System::String *sFrom, 
    System::String *sTo, 
    System::String *sCc, 
    System::String *sServer,
    System::String *sUserName,
    System::String *sPassword,
    System::String *sSubject,
    System::String *sBodyText,
    bool bSSLConnection )
{
    SmtpMail *oMail = new SmtpMail(S"TryIt");
    SmtpClient *oSmtp = new SmtpClient();
    //To generate a log file for SMTP transaction, please use
    //oSmtp->LogFileName = S"c:\\smtp.log";

    System::String *err = S"";

    try
    {
	//From is a MailAddress object, in c#, it supports implicit converting from string.
	//The syntax is like this: "test@adminsystem.com" or "Tester<test@adminsystem.com>"
				
	//The example code without implicit converting
	// oMail->From = new MailAddress( S"Tester", S"test@adminsystem.com" );
	// oMail->From = new MailAddress( S"Tester<test@adminsystem.com>" );
	// oMail->From = new MailAddress( S"test@adminsystem.com" );
	    
	//To, Cc and Bcc is a AddressCollection object, in C#, it supports implicit converting from string.
	// multiple address are separated with (,;)
	//The syntax is like this: "test@adminsystem.com, test1@adminsystem.com"

    //The example code without implicit converting
    // oMail->To = new AddressCollection( S"test1@adminsystem.com, test2@adminsystem.com" );
    // oMail->To = new AddressCollection( S"Tester1<test@adminsystem.com>, Tester2<test2@adminsystem.com>");         
    // You can add more recipient by Add method
    // oMail->>To->Add( new MailAddress( S"tester", S"test@adminsystem.com")); 
	   
        oMail->From = new EASendMail::MailAddress(sFrom);
        oMail->To =  new EASendMail::AddressCollection(sTo);
        oMail->Cc = new EASendMail::AddressCollection(sCc);
        oMail->Subject = sSubject;
        oMail->TextBody = sBodyText;
        //If the sBodyText contains the html tag, please use
        //oMail->HtmlBody = sBodyText;
        //Add attachment 
        //oMail->AddAttachment( S"c:\\test.gif" );      
                
        SmtpServer *oServer = new SmtpServer( sServer );

        if( sUserName->Length != 0 && sPassword->Length != 0 )
        {
            oServer->User = sUserName;
            oServer->Password = sPassword;
        }

        if( bSSLConnection )
            oServer->ConnectType = SmtpConnectType::ConnectSSLAuto;

        oSmtp->SendMail( oServer, oMail );
    
        MessageBox::Show( String::Format( S"The message was sent to {0} successfully!", 
            oSmtp->CurrentSmtpServer->Server ));

    }
    catch( EASendMail::SmtpTerminatedException *exp )
    {
        err = exp->Message;
    }
    catch( EASendMail::SmtpServerException *exp )
    {
        err = String::Format( S"Exception: Server Respond: {0}", exp->ErrorMessage );
    }
    catch( System::Net::Sockets::SocketException *exp )
    {
        err = String::Format( S"Exception: Networking Error: {0} {1}", exp->ErrorCode.ToString(S"d"), exp->Message );
    }
    catch( System::ComponentModel::Win32Exception *exp )
    {
        err = String::Format( S"Exception: System Error: {0} {1}", exp->ErrorCode.ToString(S"d"), exp->Message );           
    }
    catch( System::Exception *exp )
    {
        err = String::Format( S"Exception: Common: {0}", exp->Message );            
    }
    
    if( err->Length > 0  )
    {
        MessageBox::Show( err );
    }
}

[JScript.NET]
public function SendMail( sFrom:String, 
    sTo:String, 
    sCc:String, 
    sServer:String,
    sUserName:String,
    sPassword:String,
    sSubject:String,
    sBodyText:String,
    bSSLConnection:Boolean )
{
    var oMail:SmtpMail =  new SmtpMail("TryIt");
    var oSmtp:SmtpClient = new SmtpClient();
    //To generate a log file for SMTP transaction, please use
    //oSmtp.LogFileName = "c:\\smtp.log";
        
    var err:String = "";    
    try
    {   
	//From is a MailAddress object, in c#, it supports implicit converting from string.
	//The syntax is like this: "test@adminsystem.com" or "Tester<test@adminsystem.com>"
				
	//The example code without implicit converting
	// oMail.From = new MailAddress( "Tester", "test@adminsystem.com" );
	// oMail.From = new MailAddress( "Tester<test@adminsystem.com>" );
	// oMail.From = new MailAddress( "test@adminsystem.com" );
	    
	//To, Cc and Bcc is a AddressCollection object, in C#, it supports implicit converting from string.
	// multiple address are separated with (,;)
	//The syntax is like this: "test@adminsystem.com, test1@adminsystem.com"

	//The example code without implicit converting
	// oMail.To = new AddressCollection( "test1@adminsystem.com, test2@adminsystem.com" );
	// oMail.To = new AddressCollection( "Tester1<test@adminsystem.com>, Tester2<test2@adminsystem.com>");			
	  
	//You can add more recipient by Add method
	// oMail.To.Add( new MailAddress( "tester", "test@adminsystem.com"));
		    
        oMail.From  = new MailAddress(sFrom);
        oMail.Subject = sSubject
        oMail.To = new AddressCollection(sTo);
        oMail.Cc = new AddressCollection(sCc);
           
        oMail.TextBody = sBodyText;
        //If the sBodyText contains the html tag, please use
        //oMail.HtmlBody = sBodyText;
        //Add attachment 
        //oMail.AddAttachment( "c:\\test.gif" );               
        
        var oServer:SmtpServer = new SmtpServer(sServer);

        if( sUserName.Length != 0 && sPassword.Length != 0 )
        {
            oServer.User = sUserName;
            oServer.Password = sPassword;
        }

        if( bSSLConnection )
        {
            oServer.ConnectType = SmtpConnectType.ConnectSSLAuto;
        }

        oSmtp.SendMail( oServer, oMail );
        MessageBox.Show( String.Format("The message was sent to {0} successfully!", oServer.Server ));
        
    }
    catch( exp:SmtpTerminatedException  )
    {
        err = exp.Message;
    }
    catch( exp:SmtpServerException )
    {
        err = String.Format( "Exception: Server Respond: {0}", exp.ErrorMessage );
    }
    catch( exp:System.Net.Sockets.SocketException )
    {
        err = String.Format( "Exception: Networking Error: {0} {1}", exp.ErrorCode, exp.Message );
    }
    catch( exp:System.ComponentModel.Win32Exception )
    {
        err = String.Format( "Exception: System Error: {0} {1}", exp.ErrorCode, exp.Message );          
    }
    catch( exp:System.Exception )
    {
        err = String.Format( "Exception: Common: {0}", exp.Message );           
    }   
    
    if( err.Length > 0 )
    {
        MesageBox.Show( err );
    }
}