Freigeben über


Rule Klasse

Definition

Stellt eine einzelne Posteingangsregel im Postfach dar.

public ref class Rule sealed : Microsoft::Exchange::WebServices::Data::ComplexProperty
public sealed class Rule : Microsoft.Exchange.WebServices.Data.ComplexProperty
Public NotInheritable Class Rule
Inherits ComplexProperty
Vererbung

Beispiele

Im folgenden Beispiel wird eine neue Regel erstellt und auf dem Messagingserver gespeichert. Die Regel enthält eine - und Conditions -ActionsEigenschaft. Die Actions sind:

  • Die E-Mail-Nachricht wird an den Ordner JunkEmail gesendet.
  • Weisen Sie die Kategorie "Direkt" zu.
  • Weisen Sie die Kategorie "Nur interne Verwendung" zu.

Die Conditions sind:

  • Die E-Mail-Nachricht enthält das Wort "Interessant" im Betreff.
// Create an inbox rule.
// If "Interesting" is in the e-mail's subject, move it into the Junk folder
// and assign two categories to the message.
Rule newRule = new Rule();
newRule.Actions.MoveToFolder = WellKnownFolderName.JunkEmail;
newRule.Conditions.ContainsSubjectStrings.Add("Interesting");
newRule.DisplayName = "MoveInterestingToJunk";
newRule.IsEnabled = true;

newRule.Priority = 1;
newRule.Actions.AssignCategories.Add("Immediate");
newRule.Actions.AssignCategories.Add("Internal use only.");

// Create the CreateRuleOperation.
CreateRuleOperation createRuleOperation = new CreateRuleOperation(newRule);
service.UpdateInboxRules(new RuleOperation[] { createRuleOperation }, true);

Hinweise

Eine Posteingangsregel ist ein Satz von Conditions, Exceptionsund zugeordnet Actions , mit dem Clients Nachrichten automatisch organisieren, kategorisieren und darauf reagieren können, wenn die Nachrichten an einen Ordner übermittelt werden. Beispielsweise kann eine Rule erstellt werden, um festzulegen, dass alle eingehenden E-Mails, die eine bestimmte Zeichenfolge im Betreff enthalten, automatisch in einen vordefinierten Ordner verschoben werden. Rule Die Auswertung wird ausgelöst, wenn E-Mail-Nachrichten im Postfach eines Benutzers übermittelt werden oder wenn Nachrichten zum ersten Mal in einem Ordner gespeichert werden. Die Conditions in einem Rule werden anhand der Eigenschaften der eingehenden Nachricht ausgewertet. Wenn die Conditions als true ausgewertet wird, wird die Regel Actions vom Server ausgeführt.

Konstruktoren

Rule()

Initialisiert eine neue Instanz der Rule-Klasse.

Eigenschaften

Actions

Ruft die Aktionen ab, die für eine Nachricht ausgeführt werden sollen, wenn die Bedingungen erfüllt sind.

Conditions

Ruft die Bedingungen ab, die bei Erfüllung die Regelaktionen für diese Regel auslösen.

DisplayName

Ruft einen Zeichenfolgenwert ab, der den Anzeigenamen einer Regel enthält, oder legt diesen fest.

Exceptions

Ruft die Ausnahmen ab, die alle verfügbaren Regelausnahmebedingungen für die Posteingangsregel darstellen.

Id

Ruft den Regelbezeichner ab oder legt diese fest.

IsEnabled

Ruft ab oder legt fest, ob die Regel aktiviert ist.

IsInError

Ruft einen Wert ab, der angibt, ob sich die Regel in einer Fehlerbedingung befindet.

IsNotSupported

Ruft einen Wert ab, der angibt, ob die Regel nicht mit den APIs mit verwaltetem Code geändert werden kann.

Priority

Ruft die Regelpriorität ab, einen Wert, der die Reihenfolge angibt, in der eine Regel ausgeführt werden soll, oder legt diese fest.

Gilt für: