Objet RecurrencePattern (Outlook)
Représente le modèle d’incidence des rendez-vous et tâches périodiques pour les objets AppointmentItem et TaskItem associés.
Remarques
Utilisez la méthode GetRecurrencePattern pour renvoyer l’objet RecurrencePattern associé à un objet AppointmentItem ou TaskItem .
L’appel de GetRecurrencePattern ou ClearRecurrencePattern a pour effet secondaire de définir la propriété IsRecurring de l’élément en conséquence. Cette propriété peut être utilisée en fonction des besoins pour un filtrage efficace de l’objet Items .
Le type de modèle de périodicité est indiqué par la propriété RecurrenceType . Vous devez définir la propriété RecurrenceType avant toutes les autres.
Les propriétés suivantes sont valides pour tous les modèles de périodicité : EndTime, Occurrences, StartDate, StartTime ou Type.
Le tableau suivant présente les propriétés valides pour les différents types de périodicité. Une erreur se produit si l’élément est enregistré et que la propriété est null ou contient une valeur non valide. Les périodicités mensuelles et annuelles ne sont valides que pour un seul jour. Les modèles hebdomadaires sont uniquement valides en tant que or du masque DayOfWeek.
| RecurrenceType | Properties | Exemples |
|---|---|---|
| olRecursDaily | Duration, EndTime, Interval, NoEndDate, Occurrences, PatternStartDate, PatternEndDate, StartTime | La valeur N pour Interval est tous les N jours. |
| olRecursWeekly | DayOfWeekMask, Duration, EndTime, Interval, NoEndDate, Occurrences, PatternStartDate, PatternEndDate, StartTime | La valeur N pour Interval est toutes les N semaines. Un exemple de DayofWeekMask est tous les mardis, mercredis et jeudis. |
| olRecursMonthly | DayOfMonth, Duration, EndTime, Interval, NoEndDate, Occurrences, PatternStartDate, PatternEndDate, StartTime | La valeur N pour Interval est tous les N mois. La valeur N pour DayofMonth est chaque Nième jour du mois. |
| olRecursMonthNth | DayOfWeekMask, Duration, EndTime, Interval, Instance, NoEndDate, Occurrences, PatternStartDate, PatternEndDate, StartTime | La valeur N pour Interval est tous les N mois. Un exemple de valeur N pour Instance est chaque Nième mardi. Un exemple de DayofWeekMask est tous les mardis et mercredis. |
| olRecursYearly | DayOfMonth, Duration, EndTime, Interval, MonthOfYear, NoEndDate, Occurrences, PatternStartDate, PatternEndDate, StartTime | La valeur N pour DayofMonth est le Nième jour du mois. Un exemple de MonthOfYear est Février. |
| olRecursYearNth | DayOfWeekMask, Duration, EndTime, Interval, Instance, NoEndDate, Occurrences, PatternStartDate, PatternEndDate, StartTime | Un exemple de valeur N pour Instance est le Nth Tuesday. Un exemple de DayofWeekMask est le mardi, le mercredi et le jeudi. Un exemple de MonthOfYear est Février. |
Lors de l'utilisation d'éléments de rendez-vous périodique, vous devez libérer les références antérieures, le cas échéant, obtenir les nouvelles références à l'élément de rendez-vous périodique avant d'accéder à cet é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 récurrent et à tout objet Exception ou RecurrencePattern . Pour libérer une référence dans Visual Basic pour Applications (VBA) ou Visual Basic, définissez cet objet existant sur Nothing. Dans C#, libérez explicitement la mémoire pour cet objet. Pour obtenir un exemple de code, consultez la rubrique relative à l’objet AppointmentItem .
Notez que même après avoir libéré votre référence et tenté d’obtenir une nouvelle référence, s’il existe encore une référence active détenue par un autre complément ou par Outlook vers un des objets mentionnés ci-dessus, votre nouvelle référence pointera encore vers une copie périmée de l’objet. Il est donc important de libérer vos références dès que vous en avez terminé avec le rendez-vous périodique.
Méthodes
| Nom |
|---|
| GetOccurrence |
Propriétés
Voir aussi
Membres de l’objet RecurrencePattern de référence du modèle objet Outlook
Assistance et commentaires
Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.