_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
Значение true , чтобы применить правило к вложенным папкам папки, указанной параметром Folder; Значение false , чтобы применить правило только к этой папке, но не к ее вложенным папкам.
- RuleExecuteOption
- Object
Указывает, следует ли применять правило для чтения, непрочитанных или всех сообщений в папке или папках, указанных параметрами Folder и IncludeSubfolders.
Комментарии
Используйте Execute(Object, Object, Object, Object) для применения правила в качестве однократной операции независимо от того, имеет ли Enabled значение True. Используйте Rule.Enabled , а затем Save(Object) , если вы хотите применить правило согласованно и сохранить правила за пределами текущего сеанса.
Параметры метода Execute являются необязательными. Если параметры не указаны, правило будет применяться ко всем сообщениям в папке "Входящие", но не к вложенным папкам папки "Входящие". Значения по умолчанию для необязательных аргументов:
Параметр | Значение по умолчанию | |
ShowProgress | False | |
Folder | Inbox | |
IncludeSubfolders | False | |
RuleExecuteOption | OlRuleExecuteOption.olRuleExecuteAllMessages |
Если ShowProgress
имеет значение True и пользователь отменяет диалоговое окно хода выполнения, выполнение правила отменяется так же, как если бы пользователь отменил выполнение правил с помощью мастера правил и оповещений. Выполнение возвращает ошибку, когда пользователь отменяет диалоговое окно выполнения.
Если вы планируете отображать пользовательский интерфейс пользовательского хода выполнения вместо использования диалогового окна хода выполнения, следует учитывать, что нет событий, указывающих на то, когда выполнение правил начинается и останавливается.