Outlook) (Rule.Execute 方法

將規則套用為一次性作業。

語法

運算式。 Execute( _ShowProgress_ , _Folder_ , _IncludeSubfolders_ , _RuleExecuteOption_ )

運算式 代表 Rule 物件的變數。

參數

名稱 必要/選用 資料類型 描述
ShowProgress 選用 布林值 True 表示在執行規則時顯示進度對話方塊,而 False 表示在執行規則時不顯示對話方塊。
Folder 選用 Folder 代表要套用規則的資料夾。
IncludeSubfolders 選用 布林值 如果是 True,將規則套用至 Folder 參數所指出資料夾的子資料夾;False 可將規則只套用至該資料夾,而不套用至其子資料夾。
RuleExecuteOption 選用 OlRuleExecuteOption 代表是否要將規則套用至已讀取、未讀取或由 Folder 和 IncludeSubfolders 參數所指定資料夾中的所有郵件。

註解

不論 Rule.Enabled 是否為 True,使用 Rule.Execute 將規則套用為一次性作業。 如果您想一致地套用規則,而且想在目前作業階段以外持續保留規則,則請使用 Rule.Enabled,然後使用 Rules.Save。

Execute 方法的參數是選用的。 如果您未指定任何參數,規則將會套用至 [收件匣] 中的所有郵件,但不會套用至 [收件匣] 的子資料夾。 選用引數的預設值如下:

參數 預設值
Folder 收件匣
IncludeSubfolders False
RuleExecuteOption OlRuleExecuteOption.olRuleExecuteAllMessages

如果 ShowProgress 為 True ,且使用者取消進度對話方塊,則取消執行規則的方式與使用者透過 [規則和警示精靈] 取消執行規則的方式相同。 當使用者取消進度對話方塊時,[執行] 會傳回錯誤。

如果您不想使用進度對話方塊,而打算顯示自訂的進度使用者介面,請注意,將不會有任何事件可以指出規則開始與停止執行的時間。

另請參閱

規則物件

支援和意見反應

有關於 Office VBA 或這份文件的問題或意見反應嗎? 如需取得支援服務並提供意見反應的相關指導,請參閱 Office VBA 支援與意見反應。