Using ActiveEmail SMTP/POP3 Toolkit with Microsoft ASP .NET (Visual Basic)

ActiveEmail SMTP/POP3 Toolkit is a software development kit (SDK) that enables the user to send (SMTP) and receive (POP3) e-mail messages. ActiveEmail supports SMTP, POP3, multiple recipients (To, CC, BCC), multiple attachments (ASCII and binary), rich text body formats (RTF/HTML), Unicode, multiple character sets, SMTP authorization (AUTH PLAIN, AUTH LOGIN, AUTH CRAM MD5), POP3 authorization (Plain, APOP), POP3 header download, different character sets (including arabic, chinese, japanese, russian, greek and many more), different encodings (including 7/8 bit, quoted-printable, base64).

ActiveEmail can be well integrated into Microsoft Visual Studio .NET environments. This document describes how ActiveEmail can be integrated into Microsoft ASP .NET VB projects.

Prerequisites

You must install and configre Internet Information Services (IIS) before using ActiveEmail with ASP .NET
If you don't have IIS installed, use the following stpes:

From the Control Panel, click 'Add/Remove Programs'. Select the 'Add/Remove Windows Components' icon from the left pane, then select 'Application Server' and click on 'Details'. You can now select both 'ASP .NET' and 'Internet Information Services (IIS)'. Click 'OK' to continue installation;
Make sure that ASP .NET is allowed on the web server:

(Click on the picture to enlarge)

Step 1: Download and install ActiveEmail

Download the ActiveEmail SMTP/POP3 Toolkit from the ActiveXperts Download Site and start the installation. The installation guides you through the installation process.

Step 2: Create a new ASP .NET VB Project

Launch Microsoft Visual Studio (for instance 'Microsoft Visual Studio 2005') from the Start menu. Choose 'New' from the 'File' menu and click on 'Web Site'. In the 'Web Site' dialog, select ASP .NET Web Site. Select a name for the application (for instance: 'DemoApp') and a name for the solution (for instance: 'DemoSolution'). Also, select the directory where you want to store the project (for instance: 'C:\MyProjects):

(Click on the picture to enlarge)

Step 3: Refer to the ActiveEmail Library and create the objects

Now that a new project has been created, you must add a reference to ActiveEmail in the project to be able to use the ActiveEmail objects. To do so, choose 'Add Reference...' from the 'Website' menu. In the 'Add Reference' dialog that pops up, select the 'COM' tab and select the 'ActiveEmail 3.0 Type Library' as shown in the following picture:

(Click on the picture to enlarge)

Click 'OK' to close the 'Add Reference' dialog.

On top of your code, type the following line to use the ActiveEmail namespace:

   Imports AEMAILLib

In your Main function, declare and create the following objects for SMTP:

   Dim objSmtpServer As SmtpServer
   Dim objSmtpMail As SmtpMail
   
   objSmtpServer     = New SmtpServer()
   objSmtpMail       = New SmtpMail()

To use POP3, declare and create the following objects:

   Dim objPop3Server As Pop3Server
   Dim objPop3Mail As Pop3Mail

   objPop3Server     = New Pop3Server()

   ' NOTE: do NOT create the Pop3Mail object, because it is created by the Pop3Server object when a new message is received

To make use of ActiveEmail's constants, declare the EmailConstants object:

   Dim objConstants As EmailConstants
   objConstants = New EmailConstants()

Step 4: Send and/or receive an e-mail messages

You can now send and/or receive e-mail messages.

The following code shows how to send an e-mail message:

   Imports AEMAILLib

   Public Class WebForm1
      Inherits System.Web.UI.Page
      Protected WithEvents textServer As System.Web.UI.WebControls.TextBox
      Protected WithEvents buttonSend As System.Web.UI.WebControls.Button
   
      Public objSmtpServer As SmtpServer
      Public objSmtpMail As SmtpMail
      Protected WithEvents textResult As System.Web.UI.WebControls.TextBox
      Protected WithEvents textFromName As System.Web.UI.WebControls.TextBox
      Protected WithEvents textMailTo As System.Web.UI.WebControls.TextBox
      Protected WithEvents textSubject As System.Web.UI.WebControls.TextBox
      Protected WithEvents textBody As System.Web.UI.WebControls.TextBox
      Protected WithEvents textResponse As System.Web.UI.WebControls.TextBox
      Protected WithEvents labelServer As System.Web.UI.WebControls.Label
      Protected WithEvents labelFromAddress As System.Web.UI.WebControls.Label
      Protected WithEvents textFromAddress As System.Web.UI.WebControls.TextBox
      Protected WithEvents labelFromName As System.Web.UI.WebControls.Label
      Protected WithEvents LabelMailTo As System.Web.UI.WebControls.Label
      Protected WithEvents labelSubject As System.Web.UI.WebControls.Label
      Protected WithEvents labelBody As System.Web.UI.WebControls.Label
      Protected WithEvents labelResult As System.Web.UI.WebControls.Label
      Protected WithEvents labelResponse As System.Web.UI.WebControls.Label
      Public objConstants As EmailConstants
   
   #Region " Web Form Designer Generated Code "
   
      'This call is required by the Web Form Designer.
       Private Sub InitializeComponent()
   
      End Sub
   
      Private Sub Page_Init(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Init
         'CODEGEN: This method call is required by the Web Form Designer
         'Do not modify it using the code editor.
         InitializeComponent()
      End Sub
   
   #End Region
   
      Private Sub Page_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
         objSmtpServer = New SmtpServer()
         objSmtpMail = New SmtpMail()
         objConstants = New EmailConstants()
      End Sub
   
      Private Sub buttonSend_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles buttonSend.Click
   
         objSmtpServer.LogFile = "C:\\AspNetSmtpLog.txt"
   
         objSmtpServer.Connect(textServer.Text)
   
         If GetResult() = 0 Then
   
            objSmtpMail.FromAddress = textFromAddress.Text
            objSmtpMail.FromName = textFromName.Text
            objSmtpMail.AddTo(textMailTo.Text, "")
            objSmtpMail.Subject = textSubject.Text
            objSmtpMail.Body = textBody.Text
   
            objSmtpMail.BodyType = objConstants.asMESSAGE_BODY_PLAIN
            objSmtpMail.Encoding = objConstants.asMESSAGE_ENCODING_DEFAULT
            objSmtpMail.Priority = objConstants.asMESSAGE_PRIORITY_HIGH
   
            objSmtpServer.Send(objSmtpMail)
   
            GetResult()
         End If
      End Sub
   
      Private Function GetResult() As Long
         GetResult = objSmtpServer.LastError
   
         textResponse.Text = objSmtpServer.LastSmtpResponse
         textResult.Text = "ERROR " & objSmtpServer.LastError.ToString() & " : " & objSmtpServer.GetErrorDescription(objSmtpServer.LastError)
   
      End Function
   End Class

There are many working samples included with the product. You can also find them on the ActiveXperts FTP site: ftp.activexperts-labs.com/samples/activemail.

NOTE: Demo Projects are created with Microsoft Visual Studio 2002

The ActiveEmail project ships with a set of Microsoft Visual Studio .NET samples, including samples for Microsoft ASP .NET (Visual Basic). The projects are created with Microsoft Visual Studio 2002.
Users with a later version of Microsoft Visual Studio can open such a project. The Visual Studio Conversion Wizard will guide you through the process of converting the project to the version used.

ActiveEmail is a SMTP- and POP3 development component (SDK). This control can be used by any Windows development platform, including Visual Basic .NET, Visual CSharp .NET, ASP .NET (VB,CS), ASP, Visual Basic, Visual Studio/Visual C++, Delphi, PHP, HTML, VBScript and any other ActiveX/COM compliant platform. ActiveEmail is an ActiveXperts Software B.V. Product.