Rule クラス

定義

メールボックス内の個々の受信トレイ ルールを表します。

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
継承

次の例では、新しい規則を作成し、それをメッセージング サーバーに保存します。 ルールには、 プロパティと Conditions プロパティがActions含まれています。 は Actions 次のとおりです。

  • 電子メール メッセージは、JunkEmail フォルダーに送信されます。
  • "イミディエイト" のカテゴリを割り当てます。
  • "内部使用のみ" のカテゴリを割り当てます。

Conditions 次のとおりです。

  • 電子メール メッセージには、件名に "興味深い" という単語が含まれています。
// 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);

注釈

受信トレイ ルールは、メッセージがフォルダーに配信されるときに、クライアントがメッセージを自動的に整理、分類、および処理できるようにする、関連付けられた Actions 、のセットConditionsExceptionsです。 たとえば、 を Rule 作成して、件名に特定の文字列を含む受信メールを自動的に所定のフォルダーに移動するように要求できます。 Rule 評価は、電子メール メッセージがユーザーのメールボックスに配信されたとき、またはメッセージが最初にフォルダーに保存されたときにトリガーされます。 内の RuleConditions、受信メッセージのプロパティに対して評価されます。 が Conditionstrue と評価された場合、ルール Actions はサーバーによって実行されます。

コンストラクター

Rule()

Rule クラスの新しいインスタンスを初期化します。

プロパティ

Actions

条件が満たされたときにメッセージに対して実行されるアクションを取得します。

Conditions

満たされると、そのルールのルールアクションをトリガーする条件を取得します。

DisplayName

Rule の表示名を含む文字列値を取得または設定します。

Exceptions

受信トレイ ルールで使用可能なすべてのルール例外条件を表す例外を取得します。

Id

Rule 識別子を取得または設定します。

IsEnabled

Rule が有効かどうかを取得または設定します。

IsInError

Rule がエラー条件にあるかどうかを示す値を取得します。

IsNotSupported

マネージ コード API で Rule を変更できないかどうかを示す値を取得します。

Priority

規則の実行順序を示す値である Rule 優先度を取得または設定します。

適用対象