_Rule.Execute(Object, Object, Object, Object) Méthode

Définition

Applique une règle en tant qu'opération isolée.

public void Execute (object ShowProgress, object Folder, object IncludeSubfolders, object RuleExecuteOption);
Public Sub Execute (Optional ShowProgress As Object, Optional Folder As Object, Optional IncludeSubfolders As Object, Optional RuleExecuteOption As Object)

Paramètres

ShowProgress
Object

True pour afficher la boîte de dialogue de progression lors de l'exécution de la règle, False pour exécuter la règle sans afficher la boîte de dialogue.

Folder
Object

Représente le dossier où la règle sera appliquée.

IncludeSubfolders
Object

True pour appliquer la règle aux sous-dossiers du dossier indiqué par le paramètre Dossier ; False pour appliquer la règle uniquement à ce dossier mais pas à ses sous-dossiers.

RuleExecuteOption
Object

Indique s'il convient d'appliquer la règle aux messages lus, non lus ou à tous les messages dans le(s) dossier(s) spécifié(s) par les paramètres Dossier et InclureSous-Dossiers.

Remarques

Utilisez Execute(Object, Object, Object, Object) pour appliquer une règle en tant qu’opération unique, que la valeur ait Enabled ou non la valeur True. Utilisez Rule.Enabled , puis Save(Object) si vous souhaitez appliquer la règle de manière cohérente et conserver les règles au-delà de la session active.

Les paramètres de la méthode Execute sont facultatifs. Si vous ne spécifiez pas de paramètre, la règle est alors appliquée à tous messages dans la Boîte de réception, mais pas aux sous-dossiers de la Boîte de réception. Les valeurs par défaut pour les arguments facultatifs se présentent comme suit :

ParamètreValeur par défaut
ShowProgressFalse
DossierBoîte de réception
IncludeSubfoldersFalse
RuleExecuteOption OlRuleExecuteOption.olRuleExecuteAllMessages

Si ShowProgress a la valeur True et que l’utilisateur annule la boîte de dialogue de progression, l’exécution de la règle est annulée de la même manière que si l’utilisateur avait annulé l’exécution de la règle via l’Assistant Règles et alertes. L'exécution renvoie une erreur lorsque l'utilisateur annule la boîte de dialogue de progression.

Si vous envisagez d'afficher une interface utilisateur de progression personnalisée au lieu d'utiliser la boîte de dialogue de progression, vous devez savoir qu'il n'existe aucun événement qui indique le démarrage et l'arrêt d'une exécution de règle.

S’applique à