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 ,且使用者取消進度對話方塊,則規則執行的取消方式與使用者透過 [ 規則和警示精靈] 取消規則執行的方式相同。 當 使用者取消進度對話方塊時,Execute 會傳回錯誤。
如果您不想使用進度對話方塊,而打算顯示自訂的進度使用者介面,請注意,將不會有任何事件可以指出規則開始與停止執行的時間。
另請參閱
支援和意見反應
有關於 Office VBA 或這份文件的問題或意見反應嗎? 如需取得支援服務並提供意見反應的相關指導,請參閱 Office VBA 支援與意見反應。