Edit

Share via


ExchangeService.UpdateInboxRules Method

Definition

Overloads

UpdateInboxRules(IEnumerable<RuleOperation>, Boolean)

Updates a specified user's Inbox rules by applying the specified operations.

UpdateInboxRules(IEnumerable<RuleOperation>, Boolean, String)

Updates a specified user's Inbox rules by applying the specified operations.

UpdateInboxRules(IEnumerable<RuleOperation>, Boolean)

Updates a specified user's Inbox rules by applying the specified operations.

public:
 void UpdateInboxRules(System::Collections::Generic::IEnumerable<Microsoft::Exchange::WebServices::Data::RuleOperation ^> ^ operations, bool removeOutlookRuleBlob);
public void UpdateInboxRules (System.Collections.Generic.IEnumerable<Microsoft.Exchange.WebServices.Data.RuleOperation> operations, bool removeOutlookRuleBlob);
Public Sub UpdateInboxRules (operations As IEnumerable(Of RuleOperation), removeOutlookRuleBlob As Boolean)

Parameters

operations
IEnumerable<RuleOperation>

The operations that are to be applied to the specified user's Inbox rules.

removeOutlookRuleBlob
Boolean

true to remove the Outlook rule blob ; otherwise, false.

Remarks

Calling this method results in a call to Exchange Web Service (EWS).

You can use the OutlookRuleBlobExists property to determine whether to prompt the user before calling this method.

When you call the UpdateInboxRules method, EWS deletes client-side send rules. Client-side send rules are stored on the client in the rule Folder Associated Information (FAI) Message and nowhere else. EWS deletes this rule FAI message by default, based on the expectation that Outlook will recreate it. However, Outlook can't recreate rules that don't also exist as an extended rule, and client-side send rules don't exist as extended rules. As a result, these rules are lost. We suggest you consider this when designing your solution.

Applies to

UpdateInboxRules(IEnumerable<RuleOperation>, Boolean, String)

Updates a specified user's Inbox rules by applying the specified operations.

public:
 void UpdateInboxRules(System::Collections::Generic::IEnumerable<Microsoft::Exchange::WebServices::Data::RuleOperation ^> ^ operations, bool removeOutlookRuleBlob, System::String ^ mailboxSmtpAddress);
public void UpdateInboxRules (System.Collections.Generic.IEnumerable<Microsoft.Exchange.WebServices.Data.RuleOperation> operations, bool removeOutlookRuleBlob, string mailboxSmtpAddress);
Public Sub UpdateInboxRules (operations As IEnumerable(Of RuleOperation), removeOutlookRuleBlob As Boolean, mailboxSmtpAddress As String)

Parameters

operations
IEnumerable<RuleOperation>

The operations that are to be applied to the specified user's Inbox rules.

removeOutlookRuleBlob
Boolean

true to remove the existing the Outlook rule blob; otherwise, false.

mailboxSmtpAddress
String

The SMTP address of the user whose Inbox rules are to be updated.

Remarks

Calling this method results in a call to Exchange Web Service (EWS).

You can use the OutlookRuleBlobExists property to determine whether to prompt the user before calling this method.

Applies to