Deleting a recurring series by using the EWS Managed API 2.0

Bind to the recurring master item for the series you want to delete by using its unique identifier. For information about how to get the unique identifier of the recurring master item in a recurring series, see Accessing calendar items in a recurring series by using the EWS Managed API 2.0. The following code shows how to bind to an existing recurring master item and provide it with connection configuration information by using an ExchangeService object named service. The ItemId has been shortened to preserve readability.

Appointment appointment = Appointment.Bind(service, new ItemId("AAMkA="));

Delete the appointment. The following code shows how to delete a recurring series of appointments and move the recurring appointment to the Deleted Items folder. Before performing the deletion, it verifies that the appointment is a recurring master item.

if (appointment.AppointmentType == AppointmentType.RecurringMaster)
{
   appointment.Delete(DeleteMode.MoveToDeletedItems);
}

Bind to the recurring master item for the series you want to cancel by using its unique identifier. For information about how to get the unique identifier of the recurring master item in a recurring series, see Accessing calendar items in a recurring series by using the EWS Managed API 2.0. The following code shows how to bind to an existing recurring master item and provide it with connection configuration information by using an ExchangeService object named service. The ItemId has been shortened to preserve readability.

Appointment appointment = Appointment.Bind(service, new ItemId("AAMkA="));

Cancel the recurring series. You can cancel a recurring series of meetings by using one of the following:

• The CancelMeeting method, sending a generic cancellation message to all attendees, as shown in the following code. Before performing the deletion, the code verifies that the appointment is a recurring master item.

  if (appointment.AppointmentType == AppointmentType.RecurringMaster)
  {
     appointment.CancelMeeting();
  }
  

• The CancelMeeting method, sending a customized cancellation message to all attendees, as shown in the following code. Before performing the deletion, the code verifies that the appointment is a recurring master item.

  if (appointment.AppointmentType == AppointmentType.RecurringMaster)
  {
     appointment.CancelMeeting("The project has ended and these weekly status meetings are no longer necessary.");
  }
  

• The Delete method, as shown in the following code. Before performing the deletion, the code verifies that the appointment is a recurring master item. The meeting request is moved to the Deleted Items folder and a cancellation message is sent to all attendees.

  if (appointment.AppointmentType == AppointmentType.RecurringMaster)
  {
     appointment.Delete(DeleteMode.MoveToDeletedItems, SendCancellationsMode.SendOnlyToAll);
  }
  

• The CreateCancelMeetingMessage method, creating a customized cancellation message and requesting a read receipt from recipients, as shown in the following code. Before performing the deletion, the code verifies that the appointment is a recurring master item. The cancellation message is sent to all attendees and a copy of the cancellation message is saved in the sender's Sent Items folder.

  if (appointment.AppointmentType == AppointmentType.RecurringMaster)
  {
     CancelMeetingMessage cancelMessage = appointment.CreateCancelMeetingMessage();
     cancelMessage.Body = new MessageBody("The project has ended and these weekly status meetings are no longer necessary.");
     cancelMessage.IsReadReceiptRequested = true;
     cancelMessage.SendAndSaveCopy();
  }