Compartilhar via


Rule Classe

Definição

Representa uma regra de caixa de entrada individual na caixa de correio.

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
Herança

Exemplos

O exemplo a seguir cria uma nova Regra e a salva no servidor de mensagens. A regra contém uma Actions propriedade e Conditions . As Actions são:

  • A mensagem de email é enviada para a pasta JunkEmail.
  • Atribua uma categoria de "Imediato".
  • Atribua uma categoria de "Uso interno somente".

As Conditions são:

  • A mensagem de email contém a palavra "Interessante" no assunto.
// 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);

Comentários

Uma regra de caixa de entrada é um conjunto de Conditions, Exceptionse associado Actions que permite que os clientes organizem, categorizem e atuem automaticamente nas mensagens à medida que as mensagens são entregues a uma pasta. Por exemplo, um Rule pode ser criado para exigir que qualquer email de entrada que contenha uma determinada cadeia de caracteres no assunto seja movido automaticamente para uma pasta predeterminada. Rule a avaliação é disparada quando as mensagens de email são entregues na caixa de correio de um usuário ou quando as mensagens são salvas pela primeira vez em uma pasta. Os Conditions em a Rule são avaliados em relação às propriedades da mensagem de entrada. Se a avaliação Conditions for true, a regra Actions será executada pelo servidor.

Construtores

Rule()

Inicializa uma nova instância da classe Rule.

Propriedades

Actions

Obtém as ações a serem executadas em uma mensagem quando as condições são atendidas.

Conditions

Obtém as condições que, quando cumpridas, dispararão a regra Ações para essa Regra.

DisplayName

Obtém ou define um valor de cadeia de caracteres que contém o nome de exibição de uma Regra.

Exceptions

Obtém as Exceções que representam todas as condições de exceção de regra disponíveis para a regra de caixa de entrada.

Id

Obtém ou define o identificador de regra.

IsEnabled

Obtém ou define se a Regra está habilitada.

IsInError

Obtém um valor que indica se a Regra está em uma condição de erro.

IsNotSupported

Obtém um valor que indica se a Regra não pode ser modificada com as APIs de código gerenciadas.

Priority

Obtém ou define a prioridade Regra, um valor que indica a ordem na qual uma Regra deve ser executada.

Aplica-se a