_Rule.Execute(Object, Object, Object, Object) 方法

定义

将规则作为一次性操作来应用。

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) 将规则作为一次性操作应用,而不考虑是否 EnabledTrue。 如果想要一致地应用规则并Save(Object)保留当前会话以外的规则,请使用 Rule.Enabled

Execute 方法的参数是可选的。 如果不指定任何参数,则规则将应用到收件箱中的所有邮件,而不是收件箱的子文件夹。 可选参数的默认值如下所示:

参数默认值
ShowProgressFalse
文件夹收件箱
IncludeSubfoldersFalse
RuleExecuteOption OlRuleExecuteOption.olRuleExecuteAllMessages

如果 ShowProgressTrue 并且用户取消进度对话框,则取消规则执行的方式与用户通过规则和警报向导取消规则执行的方式相同。 在规则执行过程中,如果用户取消进度对话框时,则将返回错误。

如果您打算显示自定义的进度用户界面,而不使用进度对话框,则应当知道没有任何事件指示规则何时开始和停止执行。

适用于