Création d’un rendez-vous périodique selon une périodicité par défaut
Cet exemple montre comment créer un rendez-vous périodique selon une périodicité par défaut.
Exemple
Remarque
L’exemple de code suivant est un extrait de la programmation d’Applications pour Microsoft Office Outlook 2007.
Lorsque vous créez un rendez-vous dans Outlook, vous créez un objet AppointmentItem. Votre rendez-vous est un rendez-vous périodique si la propriété IsRecurring de l’objet AppointmentItem est définie sur True. Vous ne pouvez pas définir IsRecurring directement.
Néanmoins, vous pouvez créer un rendez-vous périodique à l’aide de l’objet RecurrencePattern. Pour créer un rendez-vous périodique par programme, créez un objet AppointmentItem, appelez la méthode GetRecurrencePattern() de l’objet AppointmentItem, puis enregistrez l’objet AppointmentItem. Cela crée un rendez-vous qui utilise la périodicité par défaut, qui a lieu de façon hebdomadaire le jour pour lequel le rendez-vous a été créé, et n’a aucune date de fin. L’objet RecurrencePattern permet de créer des rendez-vous périodiques à des intervalles spécifiés — quotidien, hebdomadaire, mensuel ou annuel. Si vous ne spécifiez pas d’intervalles pour l’objet RecurrencePattern, Outlook utilise la périodicité par défaut.
Lorsque vous travaillez avec des éléments de rendez-vous périodiques, vous devez libérer les références antérieures, obtenir de nouvelles références à l'élément de rendez-vous périodique avant d'accéder à l'élément ou de le modifier, et libérer ces références dès que vous avez terminé et enregistré les modifications. Cette pratique s’applique à l’objet AppointmentItem périodique, ainsi qu’aux objets Exception ou RecurrencePattern. Pour publier une référence dans Visual Basic, définissez cet objet existant sur Rien. Dans C#, libérez explicitement la mémoire utilisée par cet objet.
Notez que même après avoir libéré votre référence, si vous essayez d'en obtenir une nouvelle alors qu'il existe encore une référence active (détenue par un autre complément ou par Outlook) à l'un des objets ci-dessus, votre nouvelle référence pointe encore vers une copie obsolète de l'objet. Par conséquent, il est important de libérer vos références dès que votre utilisation du rendez-vous périodique est terminée.
Dans l’exemple suivant, la méthode CreateRecurringAppointment crée un objet AppointmentItem. Elle appelle ensuite GetRecurrencePattern. GetRecurrencePattern renvoie un objet RecurrencePattern et l’objet AppointmentItem est enregistré. Cela crée un rendez-vous périodique qui utilise la périodicité par défaut.
Si vous utilisez Visual Studio pour tester cet exemple de code, vous devez d’abord ajouter une référence au composant Bibliothèque d’objets Microsoft Outlook 15.0 et spécifier la variable lorsque vous importez l’espace de noms Microsoft.Office.Interop.Outlook. L’instruction using ne doit pas se produire juste avant les fonctions de l’exemple de code, mais doit être ajoutée avant la déclaration publique. La ligne de code suivante montre comment effectuer l’importation et l’affectation dans C#.
using Outlook = Microsoft.Office.Interop.Outlook;
private void CreateRecurringAppointment()
{
Outlook.AppointmentItem appt = Application.CreateItem(
Outlook.OlItemType.olAppointmentItem)
as Outlook.AppointmentItem;
appt.Subject = "Weekly Extensibility Team Meeting";
Outlook.RecurrencePattern pattern = appt.GetRecurrencePattern();
appt.Save();
}