How to: Find a Specific Appointment in a Recurring Appointment Series

Office 2013 and later

This example shows how to return an AppointmentItem object that represents a specific appointment in a recurring appointment series.

Programming Applications for Office Outlook 2007

The following code example is an excerpt from Programming Applications for Microsoft Office Outlook 2007, from Microsoft Press (ISBN 9780735622494, copyright Microsoft Press 2007, all rights reserved).

Buy this book

Sample chapters

To find an instance of a recurring appointment that occurs at a specified date and time, use the GetOccurrence(DateTime) method of the RecurrencePattern object to return an AppointmentItem object.

When you work with recurring appointment items, you should release any prior references, obtain new references to the recurring appointment item before you access or modify the item, and release these references as soon as you are finished and have saved the changes. This practice applies to the recurring AppointmentItem object, and any Exception or RecurrencePattern object. To release a reference in Visual Basic, set that existing object to Nothing. In C#, explicitly release the memory for that object.

Note that even after you release your reference and attempt to obtain a new reference, if there is still an active reference (held by another add-in or Outlook) to one of the above objects, your new reference will still point to an out-of-date copy of the object. Therefore, it is important that you release your references as soon as you are finished with the recurring appointment.

In the following code example, CheckOccurrenceExample uses the recurring appointment that was created in the code example in How to: Create a Recurring Appointment That Has a Weekly Pattern. It then calls the GetOccurrence method to determine whether the recurring appointment starts on the specified date and time. To ensure that the procedure will continue even if the provided information does not match the start date and time of an instance of the recurring appointment, the example uses a try…catch block. After calling the GetOccurrence method on every appointment in the recurring appointment series, CheckOccurrenceExample tests the singleAppt variable to determine whether it is set to a null reference, indicating that the method failed and did not return an AppointmentItem object.

If you use Visual Studio to test this code example, you must first add a reference to the Microsoft Outlook 15.0 Object Library component and specify the Outlook variable when you import the Microsoft.Office.Interop.Outlook namespace. The using statement must not occur directly before the functions in the code example but must be added before the public Class declaration. The following line of code shows how to do the import and assignment in C#.

using Outlook = Microsoft.Office.Interop.Outlook;
private void CheckOccurrenceExample()
    Outlook.AppointmentItem appt = Application.Session.
        "[Subject]='Recurring Appointment DaysOfWeekMask Example'")
        as Outlook.AppointmentItem;
    if (appt != null)
            Outlook.RecurrencePattern pattern =
            Outlook.AppointmentItem singleAppt =
                "7/21/2006 2:00 PM"))
                as Outlook.AppointmentItem;
            if (singleAppt != null)
                Debug.WriteLine("7/21/2006 2:00 PM occurrence found.");
        catch (Exception ex)

Other resources