Using MailBee.NET Objects in Your Projects

The following steps demonstrate how to use MailBee.NET Objects library in your applications.

Two versions of MailBee.NET.dll are shipped with the product: the generic version (for .NET Framework 2.0 and above, Client Profile compatibe), and the version optimized for .NET Framework 4.0 and above (also compatible with .NET Framework 4.0 Client Profile).

Referencing MailBee.NET Objects library

In Visual Studio .NET

In the steps below, it's assumed your Visual Studio .NET project is named EmailApp.

In the Solution Explorer, right-click the project name (EmailApp), and select Add Reference command in the context menu.
In the appeared Add Reference dialog, find MailBee.NET Objects for your .NET Framework version (in most cases, you'll have only a single item there unless you also installed MailBee.NET Objects for both .NET 2.0+ and .NET 4.0 optimized). If you have a newer version of MailBee.NET.dll (more recent than the one which came with the installer), you can click Browse button and manually locate MailBee.NET.dll file. Then double-click the reference to add it into the list and click OK. Now MailBee.NET Objects library gets referenced from your application.
In the properties of the reference added, make sure Copy Local setting is True.

In the steps above, we uploaded a copy of MailBee.NET.dll into the project folder and referenced this copy. The original MailBee.NET.dll is no longer needed. The application can be easily XCOPY deployed using this method.

You can find the detailed guide on how to reference MailBee.NET.dll at Import namespaces and set license key article (the article belongs to "IMAP and POP3" guide but the approach remains the same for all MailBee.NET components).

In non-Visual Studio .NET environment

To reference MailBee.NET Objects library in non-Visual Studio .NET application, you should manually upload MailBee.NET.dll file into the /bin folder under the root folder of your application. If there is no /bin folder, you should create it first.

The application referencing MailBee.NET Objects library in such a way can take advantage of XCOPY deployment.

Importing MailBee namespaces

Once MailBee.NET Objects library is referenced from your application, the next step is to import namespaces declared in the library, into your application. In the code below, we import all the available namespaces. You may keep only those declarations of namespaces which are actually used by your application.

Place the lines below at the top of your code file:

[Visual Basic]
Imports MailBee
Imports MailBee.DnsMX
Imports MailBee.Mime
Imports MailBee.SmtpMail
Imports MailBee.Pop3Mail
Imports MailBee.ImapMail
Imports MailBee.Security
Imports MailBee.AntiSpam
Imports MailBee.Outlook
Imports MailBee.Pdf

[C#]
using MailBee;
using MailBee.DnsMX;
using MailBee.Mime;
using MailBee.SmtpMail;
using MailBee.Pop3Mail;
using MailBee.ImapMail;
using MailBee.Security;
using MailBee.AntiSpam;
using MailBee.Outlook;
using MailBee.Pdf;

[ASP.NET Web Forms page]
<%@ Import Namespace="MailBee" %>
<%@ Import Namespace="MailBee.DnsMX" %>
<%@ Import Namespace="MailBee.Mime" %>
<%@ Import Namespace="MailBee.SmtpMail" %>
<%@ Import Namespace="MailBee.Pop3Mail" %>
<%@ Import Namespace="MailBee.ImapMail" %>
<%@ Import Namespace="MailBee.Security" %>
<%@ Import Namespace="MailBee.AntiSpam" %>
<%@ Import Namespace="MailBee.Outlook" %>
<%@ Import Namespace="MailBee.Pdf" %>

Assigning the license key

To unlock the product in trial or permanent mode, you need to assign the license key to the licensed component. The license key can be specified in config file (app.config, web.config, or machine.config), in Windows registry (SaveKey and SaveKeyGui utilities can place the license key into the registry), or in static (Shared in Visual Basic) LicenseKey property of the licensed component. See Using License Keys topic on how to obtain and specify the license key.

Usage example

Now you can use MailBee.NET Objects classes in your application. In this sample, we send a simple e-mail message with a single line of code.

[Visual Basic]
Smtp.QuickSend("from@me.com", "to@you.com", "Hello", "How are you?")

[C#]
Smtp.QuickSend("from@me.com", "to@you.com", "Hello", "How are you?");

Send feedback to AfterLogic