CreateRuleOperation Class

Definition

public ref class CreateRuleOperation sealed : Microsoft::Exchange::WebServices::Data::RuleOperation

public sealed class CreateRuleOperation : Microsoft.Exchange.WebServices.Data.RuleOperation

Public NotInheritable Class CreateRuleOperation
Inherits RuleOperation

Inheritance

Object

ComplexProperty

RuleOperation

CreateRuleOperation

Examples

The following example creates a rule with the name "MoveInterestingToJunk". The rule has a Conditions property that specifies that whenever an e-mail message arrives that has the string "Interesting" in the subject line, the message is to be moved to the Junk E-mail folder. The rule is uploaded to the server in the service.UpdateInboxRules(new RuleOperation[] { createOperation }, true) line.

// Create an Inbox rule.
// If "Interesting" is in the message's subject line, move it into the Junk E-mail folder.
Rule newRule = new Rule();
newRule.DisplayName = "MoveInterestingToJunk";
newRule.Priority = 1;
newRule.IsEnabled = true;
newRule.Conditions.ContainsSubjectStrings.Add("Interesting");
newRule.Actions.MoveToFolder = WellKnownFolderName.JunkEmail;

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

Remarks

Inbox rules are sets of Conditions and associated Actions that enable clients to automatically organize, categorize, and act on messages as the messages are delivered to a folder.

This class derives from the RuleOperation class.

When a rule is created, it is stored on the Exchange server. When a message arrives, the Exchange server evaluates the message and determines whether it has fulfilled any rule Conditions. If it has, the Exchange server will then process the message according to the rule Actions. For example, a rule can be created to require that any incoming mail that contains a certain string in the subject be automatically moved to a predetermined folder.

Constructors

Properties

Applies to