Click here to Skip to main content
Click here to Skip to main content

Introduction to Interop with Outlook, VSTO and C#

, 29 May 2007 CPOL
Rate this:
Please Sign up or sign in to vote.
This article shows you how to create an Outlook addin with VSTO and read some information about contacts
Screenshot - outlook1.png

Introduction

This article shows how to create a simple Microsoft Office Outlook Addin which adds a button and displays some information about the contacts of a specified folder.

This is my first CodeProject article. I hope it provides everything you need!

Background

This sample uses VSTO 2005 SE (Visual Studio Tools for Office 2005 SE) for creating the Addin.

You can get VSTO here.

Microsoft Office (at least Outlook) must be installed!

Using the Code

I assume you are able to create an Outlook addin with VSTO. If you are not, you should read related articles (MSDN provides a lot of information) or use the sample project provided with this article.

Please check out the sample source code for details of the implementation!

First we have to create a button for our addin:

//First we try to get the default toolbar
Office.CommandBars cmdBars = Application.ActiveExplorer().CommandBars;

//In the German version of Outlook the default command bar
//is named "Standard". In other language versions of Outlook
//this name could differ, then you need to modify the next line
Office.CommandBar cmdBar = cmdBars["Standard"];

//Try to get the existing Button
try
{
    m_btnSampleAddin = (Office.CommandBarButton)cmdBar.Controls[SampleButtonTag];
}
catch (Exception)
{
    m_btnSampleAddin = null;
}

//If the button doesn't exist, create a new one
if (m_btnSampleAddin == null)
{
    m_btnSampleAddin = (Office.CommandBarButton)cmdBar.Controls.Add(
    1, missing, missing, missing, missing);

    m_btnSampleAddin.Style = Microsoft.Office.Core.MsoButtonStyle.msoButtonCaption;
    m_btnSampleAddin.Caption = SampleButtonTag;
    m_btnSampleAddin.Tag = SampleButtonTag;
}

//Add a click handler for this button
m_btnSampleAddin.Click +=
 new Microsoft.Office.Core._CommandBarButtonEvents_ClickEventHandler
		(m_btnSampleAddin_Click);

Within the click event handler of our newly created button, we let the user select an Outlook Folder using the default folder selection dialog:

Screenshot - outlook4.png

Outlook.MAPIFolder folder = Application.Session.PickFolder(); 

If the user has selected a folder and confirmed this action by clicking "OK" the value of "folder" will be != null. In this case we show the "contacts" dialog and pass the selected folder to the constructor.

if (folder != null)
{
    ContactDisplay contactDisplay = new ContactDisplay(folder);
    contactDisplay.Show();
} 

Within the load method of the contacts form, we will iterate through all objects in the specified folder. If the object is a "contact" item, we will add it to our list control:

foreach (object objItem in m_folder.Items)
{
    //if the item is an Outlook contact, display its information in the listview
    if (objItem is Outlook.ContactItem)
    {
        Outlook.ContactItem contact = objItem as Outlook.ContactItem;
        //Fill the list view item with some information about the contact
        ListViewItem lvi = new ListViewItem(new string[]{
            contact.FirstName,
            contact.LastName,
            contact.FullName,
            contact.Email1Address
        });

        //and finally set the contact as the list view item's tag so we
        //later can access this contact object
        lvi.Tag = contact;

        lvContacts.Items.Add(lvi);
    }
} 

It's important to preserve the ContactItem object in the ListViewItem Tag so that we can access this item later!

Screenshot - outlook5.png

If you double click a listview item, we read the tag and cast it to an Outlook ContactItem. Thereafter we will show the inspector of this item.

//If a list view item has been selected
if (lvContacts.SelectedItems.Count > 0)
{
    ListViewItem lvi = lvContacts.SelectedItems[0];

    //get the contact information from the item tag
    Outlook.ContactItem contact = lvi.Tag as Outlook.ContactItem;

    //and display the outlook inspector of the contact
    contact.GetInspector.Display(Type.Missing);
} 

The Inspector is an object which is nearly available for every Outlook item and shows you the default Outlook view for that item.

Points of Interest

With the old component model of Office, you had to mess with some restrictions (for example you weren't able to read the email address of contacts without prior authorization of the user). Creating Office Addins with VSTO is also much easier to do!

History

  • 31.05.2007: Article updated
  • 30.05.2007: Initial release

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

Share

About the Author

Christoph Schick
Web Developer
Austria Austria
No Biography provided

Comments and Discussions

 
GeneralRemove button PinmemberNguyen Phuoc Dai22-Aug-07 15:45 
AnswerRe: Remove button Pinmembercschickat23-Aug-07 8:26 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Mobile
Web01 | 2.8.141029.1 | Last Updated 29 May 2007
Article Copyright 2007 by Christoph Schick
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid