_Rule.Execute(Object, Object, Object, Object) Methode

Definition

Namespace:

Microsoft.Office.Interop.Outlook

Assembly:

Microsoft.Office.Interop.Outlook.dll

Wendet eine Regel als einmaligen Vorgang an.

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)

Parameter

ShowProgress

Object

True, wenn das Dialogfeld Status angezeigt wird, wenn die Regel ausgeführt wird, False, wenn die Regel ausgeführt wird, ohne das Dialogfeld anzuzeigen.

Folder

Object

Stellt den Ordner dar, in dem die Regel angewendet wird.

IncludeSubfolders

Object

True, um die Regel auf Unterordner des durch den Parameter Folder angegeben anzuwenden. False, wenn die Regel nur auf diesen Ordner jedoch nicht seine Unterordner anzuwenden.

RuleExecuteOption

Object

Gibt an, ob die Regel auf gelesene, ungelesene oder alle Nachrichten in den durch die Parameter Folder und IncludeSubfolders angegebenen Ordnern angewendet werden soll.

Hinweise

Verwenden Sie Execute(Object, Object, Object, Object) , um eine Regel als einmaligen Vorgang anzuwenden, unabhängig davon, ob EnabledTrue ist. Verwenden Sie Rule.Enabled und dann Save(Object) , wenn Sie die Regel konsistent anwenden und die Regeln über die aktuelle Sitzung hinaus beibehalten möchten.

Der Parameter der Execute -Methode sind optional. Wenn Sie keine Parameter nicht angeben, wird die Regel auf alle Nachrichten im Posteingang, jedoch nicht für die Unterordner des Posteingangs angewendet werden. Die Standardwerte für die optionalen Argumente sind wie folgt:

	Parameter	Standardwert
	ShowProgress	False
	Ordner	Posteingang
	IncludeSubfolders	False
	RuleExecuteOption	OlRuleExecuteOption.olRuleExecuteAllMessages

Wenn ShowProgresstrue ist und der Benutzer das Statusdialogfeld abbricht, wird die Regelausführung auf die gleiche Weise abgebrochen, als ob der Benutzer die Regelausführung über den Assistenten für Regeln und Warnungen abgebrochen hätte. Execute gibt einen Fehler zurück, wenn der Benutzer Statusdialogfelds abbricht.

Wenn Sie anstelle des Dialogfelds mit dem Fortschritt eine benutzerdefinierte Benutzeroberfläche für den Fortschritt anzeigen möchten, sollten Sie beachten, dass durch keine Ereignisse angegeben wird, wann die Ausführung einer Regel beginnt und wann sie endet.