Partager via


Rule Classe

Définition

Représente une règle de boîte de réception individuelle dans la boîte aux lettres.

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
Héritage

Exemples

L’exemple suivant crée une règle et l’enregistre sur le serveur de messagerie. La règle contient une Actions propriété et Conditions . Les Actions sont les suivants :

  • Le message électronique est envoyé au dossier JunkEmail.
  • Affectez une catégorie « Immédiat ».
  • Affectez une catégorie « Usage interne uniquement ».

Les Conditions sont les suivants :

  • Le message électronique contient le mot « Intéressant » dans l’objet.
// 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);

Remarques

Une règle de boîte de réception est un ensemble de Conditions, Exceptionset associés Actions qui permettent aux clients d’organiser, de catégoriser et d’agir automatiquement sur les messages à mesure que les messages sont remis à un dossier. Par exemple, un Rule peut être créé pour exiger que tout courrier entrant contenant une certaine chaîne dans l’objet soit automatiquement déplacé vers un dossier prédéterminé. Rule L’évaluation est déclenchée lorsque des messages électroniques sont remis dans la boîte aux lettres d’un utilisateur ou lorsque les messages sont enregistrés pour la première fois dans un dossier. Les Conditions dans un Rule sont évalués par rapport aux propriétés du message entrant. Si la Conditions valeur est true, la règle Actions est exécutée par le serveur.

Constructeurs

Rule()

Initialise une nouvelle instance de la classe Rule.

Propriétés

Actions

Obtient les actions à effectuer sur un message lorsque les conditions sont remplies.

Conditions

Obtient les conditions qui, lorsqu’elles sont remplies, déclenchent les actions de règle pour cette règle.

DisplayName

Obtient ou définit une valeur de chaîne qui contient le nom complet d’une règle.

Exceptions

Obtient les exceptions qui représentent toutes les conditions d’exception de règle disponibles pour la règle de boîte de réception.

Id

Obtient ou définit l’identificateur de règle.

IsEnabled

Obtient ou définit si la règle est activée.

IsInError

Obtient une valeur qui indique si la règle est dans une condition d’erreur.

IsNotSupported

Obtient une valeur qui indique si la règle ne peut pas être modifiée avec les API de code managé.

Priority

Obtient ou définit la priorité de la règle, une valeur qui indique l’ordre dans lequel une règle doit être exécutée.

S’applique à