將規則套用為一次性作業。
語法
運算式。
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 支援與意見反應。