RecurrencePattern Interface
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Représente le modèle d’incidence des rendez-vous et des tâches périodiques pour l’objet et TaskItem associéAppointmentItem.
public interface class RecurrencePattern
[System.Runtime.InteropServices.Guid("00063044-0000-0000-C000-000000000046")]
public interface RecurrencePattern
Public Interface RecurrencePattern
- Attributs
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 RecurrenceType propriété . 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, StartTimeou 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 valides uniquement en tant que or du DayOfWeekMask .
olRecursDaily | Duration, EndTime, Interval, NoEndDate, Occurrences, PatternStartDate, PatternEndDate, StartTime | |
olRecursWeekly | DayOfWeekMask, Duration, EndTime, Interval, NoEndDate, Occurrences, PatternStartDate, PatternEndDate, StartTime | |
olRecursMonthly | DayOfMonth, Duration, EndTime, Interval, NoEndDate, Occurrences, PatternStartDate, PatternEndDate, StartTime | |
olRecursMonthNth | DayOfWeekMask, Duration, EndTime, Interval, Instance, NoEndDate, Occurrences, PatternStartDate, PatternEndDate, StartTime | |
olRecursYearly | DayOfMonth, Duration, EndTime, Interval, MonthOfYear, NoEndDate, Occurrences, PatternStartDate, PatternEndDate, StartTime | |
olRecursYearNth | DayOfWeekMask, Duration, EndTime, Interval, Instance, NoEndDate, Occurrences, PatternStartDate, PatternEndDate, StartTime |
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 récurrent AppointmentItem et à tout Exception objet ou RecurrencePattern . Pour libérer une référence dans Visual Basic, définissez l'objet existant comme Nothing. 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 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.
Propriétés
Application |
Renvoie un Application objet qui représente l’application Outlook parente pour l’objet . En lecture seule. |
Class |
Retourne une OlObjectClass constante indiquant la classe de l’objet. En lecture seule. |
DayOfMonth |
Renvoie ou définit une valeur Integer (int en C#) indiquant le jour du mois auquel le rendez-vous ou la tâche périodique se produit. Lecture-écriture. |
DayOfWeekMask |
Renvoie ou définit une OlDaysOfWeek constante représentant le masque pour les jours de la semaine où le rendez-vous ou la tâche périodique se produit. Lecture-écriture. |
Duration |
Renvoie ou définit une valeur Integer (int en C#) indiquant la durée (en minutes) du RecurrencePattern. Lecture-écriture. |
EndTime |
Renvoie ou définit une valeur DateTime indiquant l’heure de fin d’un modèle de périodicité. En lecture/écriture |
Exceptions |
Retourne la Exceptions collection pour une série spécifiée de rendez-vous périodiques. En lecture seule. |
Instance |
Renvoie ou définit une valeur Integer (int en C#) spécifiant le nombre pour lequel le modèle de périodicité est valide pour un intervalle donné. Lecture-écriture. |
Interval |
Renvoie ou définit une valeur Integer (int en C#) spécifiant le nombre d’unités d’un type de périodicité donné entre les occurrences. Lecture-écriture. |
MonthOfYear |
Renvoie ou définit une valeur Integer (int en C#) indiquant le mois de l’année qui est valide pour le modèle de périodicité spécifié. En lecture/écriture |
NoEndDate |
Retourne une valeur booléenne (bool en C#) qui indique True si le modèle de périodicité n’a pas de date de fin. Lecture-écriture. |
Occurrences |
Renvoie ou définit une valeur Integer (int en C#) indiquant le nombre d’occurrences du modèle de périodicité. En lecture/écriture |
Parent |
Renvoie la valeur de type Object parent de l’objet spécifié. En lecture seule. |
PatternEndDate |
Renvoie ou définit une valeur DateTime indiquant la date de fin du modèle de périodicité. En lecture/écriture |
PatternStartDate |
Renvoie ou définit une valeur DateTime indiquant la date de début du modèle de périodicité. Lecture-écriture. |
RecurrenceType |
Renvoie ou définit une OlRecurrenceType constante spécifiant la fréquence des occurrences pour le modèle de périodicité. En lecture/écriture |
Regenerate |
Retourne une valeur booléenne (bool en C#) qui indique True si la tâche doit être régénérée après ce passage par le modèle de périodicité. En lecture/écriture |
Session |
Retourne l’objet NameSpace pour la session active. En lecture seule. |
StartTime |
Renvoie ou définit une valeur DateTime indiquant l’heure de début d’un modèle de périodicité. En lecture/écriture |
Méthodes
GetOccurrence(DateTime) |
Retourne une instance spécifique de l’objet AppointmentItem à la date spécifiée. |