_Rule.Execute(Object, Object, Object, Object) 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
将规则作为一次性操作来应用。
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)参数
- ShowProgress
- Object
True 在执行规则时显示进度对话框， False 而不显示对话框中运行该规则。
- Folder
- Object
代表将要应用规则的文件夹。
- IncludeSubfolders
- Object
真 要将规则应用于由 Folder参数，则该文件夹的子文件夹 假 以该规则仅应用于该文件夹中，但不是包括子文件夹。
- RuleExecuteOption
- Object
代表是否向由 Folder 和 IncludeSubfolders 参数指定的一个或多个文件夹中的已读邮件、未读邮件或所有邮件应用规则。
注解
使用 Execute(Object, Object, Object, Object) 将规则作为一次性操作应用，而不考虑是否 Enabled 为 True。 如果想要一致地应用规则并Save(Object)保留当前会话以外的规则，请使用 Rule.Enabled。
Execute 方法的参数是可选的。 如果不指定任何参数，则规则将应用到收件箱中的所有邮件，而不是收件箱的子文件夹。 可选参数的默认值如下所示:
| 参数 | 默认值 | |
| ShowProgress | False | |
| 文件夹 | 收件箱 | |
| IncludeSubfolders | False | |
| RuleExecuteOption | OlRuleExecuteOption.olRuleExecuteAllMessages |
如果 ShowProgress 为 True 并且用户取消进度对话框，则取消规则执行的方式与用户通过规则和警报向导取消规则执行的方式相同。 在规则执行过程中，如果用户取消进度对话框时，则将返回错误。
如果您打算显示自定义的进度用户界面，而不使用进度对话框，则应当知道没有任何事件指示规则何时开始和停止执行。