ExchangeService.UpdateInboxRules Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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.