We recommend using Visual Studio 2017
This documentation is archived and is not being maintained.

How to: Read Data from a Custom Field of an Item

This example reads data from a custom field of a contact item. This example checks contacts in a folder named Picnic for a value in a custom text field named Picnic. The code displays the name of all contacts that have the value Potato Salad.

Applies to: The information in this topic applies to application-level projects for Outlook 2007 and Outlook 2010. For more information, see Features Available by Office Application and Project Type.

private void ThisAddIn_Startup(object sender,
    System.EventArgs e)
    System.Text.StringBuilder result =
        new System.Text.StringBuilder();

    Outlook.MAPIFolder contactFolder = this.
    Outlook.Items picnicMembers = contactFolder.Items.
        Restrict("[Picnic]='Potato Salad'");
    foreach (Outlook.ContactItem contact in picnicMembers)

    if (result.Length > 0)
        MessageBox.Show(result.ToString(), "Potato Salad");
        MessageBox.Show("No contacts are assigned potato salad"
            + " for the picnic.", "Potato Salad");

A COMException exception is thrown if the custom contact folder Picnic is not found in the folders collection. You can catch this exception and create the folder if it is missing.