ClearRecurrencePattern Method (AppointmentItem Object)

Exchange Server 2003

Topic Last Modified: 2004-06-09

The ClearRecurrencePattern method removes any recurrence settings from this appointment.

objAppointment.ClearRecurrencePattern( )

The ClearRecurrencePattern method sets the IsRecurring property to False and dissociates this AppointmentItem object from any RecurrencePattern object it might have had assigned to it.

ClearRecurrencePattern calls Release on the RecurrencePattern object. This is normally the final Release because the RecurrencePattern object applies only to its parent appointment and cannot be used for any other AppointmentItem object. The RecurrencePattern object is removed from memory in response to its final Release.

The ClearRecurrencePattern method is only valid on a nonrecurring appointment or an appointment originating a recurring series. An attempt to call it on an individual recurrence in a series returns CdoE_NO_SUPPORT.

Calendar folders are not supported in the public folders store provided with Microsoft® Exchange, and AppointmentItem objects are stored as Message objects. An attempt to call ClearRecurrencePattern in this case returns CdoE_NO_SUPPORT.

The effect of the ClearRecurrencePattern operation is not permanent until you call the Update method on the AppointmentItem object.

Calling ClearRecurrencePattern does not immediately invalidate references to individual recurrences that have been instantiated. You can still access the properties and methods of an individual recurrence, but when you call Update to make your changes persistent, you get a return of CdoE_INVALID_OBJECT.