Client Login Contact Us imi : home



News Releases
About imi
Why We're Here
Technology Partners
Join Our Team

by Caspar Boekhoudt

Download complete source code Introduction

In this article I will give you an example of how to add an e-mail to your Microsoft Outlook outbox folder using C# and/or This example also show how easy it is to call functions written in from C#.

The code consists of three classes: Form1.cs, CSharp.OutlookMail.cs, VBNET.OutlookMail.vb
Form1: a simple Windows Forms which shows how easy it is to call a C# or function.
CSharp.OutlookMail.cs: C# class with one function to add an e-mail to outlook outbox
VBNET.OutlookMail.cs: class with one function to add an e-mail to outlook outbox

The first thing you need to do is to add a reference to "Microsoft Outlook 9.0 Object Library" Click on add Reference, select the COM tab and select "Microsoft Outlook 9.0 Object Library".

public class OutlookMail{

private Outlook.Application oApp;
private Outlook._NameSpace oNameSpace;
private Outlook.MAPIFolder oOutboxFolder;
public OutlookMail()
//Return a reference to the MAPI layer
oApp = new Outlook.Application();

The Namespace object represents the messaging service provider. In order to get access to all Outlook folders and items we have to use the MAPI namespace.

oApp = new Outlook.Application();
oNameSpace= oApp.GetNamespace("MAPI");

Now that we have the MAPI namespace, we can log on using using:

<mapinamespace>.Logon(object Profile, object Password, object ShowDialog, object NewSession)
Profile: This is a string value that indicates what MAPI profile to use for logging on. Set this to null if using the currently logged on user, or set to an empty string ("") if you wish to use the default Outlook Profile.
Password: The password for the indicated profile. Set to null if using the currently logged on user, or set to an empty string ("") if you wish to use the default Outlook Profile password.
ShowDialog: Set to True to display the Outlook Profile dialog box.
NewSession: Set to True to start a new session or set to False to use the current session.


We now choose which folder we want to work with. A MAPIFolder object represents a single Outlook folder. For example you could use:

Calender: Outlook.OlDefaultFolders.olFolderCalendar
Contacts: Outlook.OlDefaultFolders.olFolderContacts
Inbox: Outlook.OlDefaultFolders.olFolderInbox

For this example we choose the Outbox folder

//gets defaultfolder for my Outlook Outbox
oOutboxFolder = oNameSpace.GetDefaultFolder(Outlook.OlDefaultFolders.olFolderOutbox);

The following function takes 3 string as parameters. These will be the values that we will add to the to, subject and the email body fields. We create a MailItem, and set the To, Subject, and Body fields.

public void addToOutBox(string toValue, string subjectValue, string bodyValue)
Outlook._MailItem oMailItem = (Outlook._MailItem)oApp.CreateItem(Outlook.OlItemType.olMailItem);
oMailItem.To = toValue;
oMailItem.Subject = subjectValue;
oMailItem.Body = bodyValue;
oMailItem.SaveSentMessageFolder = oOutboxFolder;

//uncomment this to also save this in your draft

//adds it to the outbox


Microsoft .NET is extremely powerful and yet simple to work with. In this example, I showed how to add e-mail to Outlook outbox. In the next verion, I will add functions to add tasks, calender and contacts items.

About the Author

Caspar Boekhoudt is a Consultant for Information Methodologies Inc. (imi), higher ed's leading enterprise web integrator. He has a M.S. in Computer Science and is a Sun Certified Programmer for the Java 2 Platform and IBM Certified Developer, XML and Related Technologies V1.

This article originally published at C# Corner.