Verwaltungsregeln im Objektmodell von Outlook
Das Rules-Objektmodell unterstützt das programmgesteuerte Hinzufügen, Bearbeiten und Löschen von Regeln. Mit den Sammelobjekten Rule und Rules können Sie auf Regeln zugreifen, Regeln hinzufügen und Regeln löschen, die für eine Sitzung definiert sind. Die RuleAction - und RuleCondition-Objekte , ihre Auflistungsobjekte sowie abgeleitete Aktions- und Bedingungsobjekte unterstützen die Bearbeitung von Aktionen und Bedingungen weiter.
Hinweis
Das Rules-Objektmodell bietet eine partielle Parität mit dem Regel- und Warnungs-Assistenten auf der Outlook-Benutzeroberfläche. Obwohl dieser nicht jede einzelne Regel unterstützt, die Sie mit dem Assistenten erstellen könnten, werden die am häufigsten verwendeten Regelaktionen und -bedingungen unterstützt. Genau wie jede Regel, die mithilfe des Assistenten für Regeln und Warnungen erstellt wurde, werden programmgesteuert erstellte Regeln auf Nachrichten angewendet, die E-Mail-Elemente, Besprechungsanfragen, Aufgabenanfragen, Dokumente, Zustellbestätigungen, Lesebestätigungen, Abstimmungsantworten und Abwesenheitsbenachrichtigungen umfassen.
Verwenden Sie Store.GetRules, um ein Rules-Auflistungsobjekt abzurufen, das die für den in der aktuellen Sitzung verwendeten Speicher definierten Regeln darstellt.
Nachdem Sie den Regelsatz für die aktuelle Sitzung abgerufen haben, können Sie neue Regeln hinzufügen (mithilfe von Rules.Create), vorhandene Regeln bearbeiten (indem Sie Regeln aktivieren oder deaktivieren, deren Ausführungsreihenfolge ändern und Regelaktionen und Regelbedingungen ändern) oder Regeln (mithilfe von Rules.Remove) aus dieser Regelsammlung löschen. Beachten Sie, dass Sie zwar Regeln bearbeiten können, die in Outlook-Versionen vor Microsoft Office Outlook 2007 erstellt wurden, Sie jedoch keine früheren Versionen von Outlook verwenden können, um Regeln zu bearbeiten, die in Office Outlook 2007 oder höher erstellt wurden.
Sie können jede Regel in einer Rules-Auflistung abrufen, indem Sie die Auflistung mithilfe von Rules.Item(Index) indizieren, wobei Index entweder der Name der Regel (die Standardeigenschaft Rule.Name) oder ein Wert zwischen 1 und der Gesamtzahl der Regeln in der Auflistung Rules.Count ist.
Rule.ExecutionOrder gibt die Ausführungsreihenfolge der Regeln in der Auflistung an und wird direkt dem numerischen Wert von Index in Rules.Items(Index) zugeordnet. Beispielsweise Rules.Item(1) stellt eine Regel mit Rule.ExecutionOrder den Wert 1 dar, stellt eine Regel dar, Rules.Item(2) wobei Rule.ExecutionOrder 2 ist, und Rules.Item(Rules.Count) stellt die Regel dar, wobei Rule.ExecutionOrderRules.Count ist.
Nachdem Sie eine Regel definiert haben, sollten Sie sie auch aktivieren, indem Sie die Rule.Enabled-Eigenschaft auf True festlegen und die Regel dann mithilfe von Rules.Save speichern, damit die Regel und ihr aktivierter Zustand über die aktuelle Sitzung hinaus beibehalten werden. Eine Regel ist nur verfügbar, nachdem sie erfolgreich gespeichert wurde. Beachten Sie, dass Rules.Save in Bezug auf die Leistung bei langsamen Verbindungen mit Dem Exchange-Server ein teurer Vorgang sein kann. Sie können optional ein Statusdialogfeld anzeigen, in dem der Benutzer den Vorgang abbrechen kann. Ein Speichervorgang schlägt fehl, wenn der Benutzer dieselbe Regel im Regel- und Warnungs-Assistenten bearbeitet oder das Statusdialogfeld abbricht. In solchen Fällen löst Rules.Save einen Fehler aus, und der Benutzer löst den Konflikt, indem er auf das Fehlerdialogfeld reagiert, das vom Assistenten für Regeln und Warnungen angezeigt wird.
Wenn Sie Rules.Save verwenden, um eine oder mehrere Regeln zu speichern, die in Office Outlook 2007 erstellt wurden, werden Sie mit einem Dialogfeld aufgefordert, um Sie daran zu erinnern, dass Sie diese Regel nicht mit früheren Versionen von Outlook bearbeiten können. Sie müssen das Dialogfeld bestätigen, bevor der Speichervorgang fortgesetzt werden kann.
Verwenden Sie Rule.Execute , um eine Regel auszuführen. Beachten Sie, dass während Sie zum Verwenden einer Regel über die aktuelle Sitzung hinaus eine Regel aktivieren und speichern müssen, Sie eine Regel unabhängig von deren Aktivierungsstatus ausführen können. Beim Ausführen einer Regel können Sie optional den Ordner angeben, auf den die Regel anzuwenden ist. Standardmäßig wird die Regel für alle Nachrichten im Posteingang, aber nicht für Unterordner des Posteingangs ausgeführt.
Support und Feedback
Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.