_Items.IncludeRecurrences Propriété

Définition

Espace de noms:

Microsoft.Office.Interop.Outlook

Assembly:

Microsoft.Office.Interop.Outlook.dll

Retourne une valeur booléenne (bool en C#) qui indique True si la Items collection doit inclure des modèles de périodicité. En lecture/écriture

public:
 property bool IncludeRecurrences { bool get(); void set(bool value); };

public bool IncludeRecurrences { get; set; }

Public Property IncludeRecurrences As Boolean

Valeur de propriété

Boolean

Remarques

Cette propriété a un effet uniquement si la collection Items contient des rendez-vous et n’est triée par aucune propriété autre que Start dans l’ordre croissant. La valeur par défaut est False. Utilisez cette propriété lorsque vous souhaitez récupérer tous les rendez-vous pour une date donnée, où normalement les rendez-vous périodiques ne figureraient pas car ils ne sont pas associés à une date spécifique. Si vous devez trier et filtrer des éléments de rendez-vous qui contiennent des rendez-vous périodiques, vous devez procéder dans cet ordre : triez les éléments par ordre croissant, attribuez à IncludeRecurrences la valeur True, puis filtrez les éléments. Pour un exemple illustrant cet ordre, voir l’exemple ci-dessous. Si la collection comporte des rendez-vous périodiques sans date de fin et que cette propriété a la valeur True, la collection obtenue risque d’être infinie. Pensez à bien tester cette condition dans les boucles. Il est conseillé de ne pas utiliser la propriété Count de la collection Items lorsque vous procédez à une itération de la collection Items alors que la propriété IncludeRecurrence a la valeur True. La valeur de Count sera indéfinie.

Attention : si vous filtrez une liste triée d’occurrences, la propriété IncludeRecurrences ne fonctionnera pas comme prévu. Par exemple, la séquence suivante retourne toutes les occurrences de rendez-vous ; périodiques et non récurrents : (1) Trier par propriété Start (2) Définir la propriété sur false (3) appeler Restrict (c’est-à-dire, filtrer).