_Items.IncludeRecurrences Propriété
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.
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 BooleanValeur de propriété
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).