Method Rule

Namespace: MailFathom.Domain.Delivery

Assembly: MailFathom.Domain.dll

Rule(string, string, StoredEmailId)

Names a rule together with the revision of it that asked, and the email it acted on.

public static OutgoingEmailRequester Rule(string ruleName, string revision, StoredEmailId actedOn)

Parameters

ruleName string: The operator's own name for the rule.
revision string: The identity of the rule set revision the request was produced from.
actedOn StoredEmailId: The local email the rule matched, which is what makes one rule's two sends two requests.

Returns

OutgoingEmailRequester: A requester naming that revision of that rule acting on that email.

Remarks

The email is part of the identity here and is not part of a mutation's, because the two records are keyed differently: a mutation is recorded against the occurrence it changes, so its requester never has to name one, while an outgoing email is recorded against an account and would otherwise let one rule send once for a whole mailbox. The value is MailFathom's own local identifier rather than anything the message said.

Exceptions

ArgumentException: Thrown when ruleName or revision is blank, carries a control character, carries one of the @ and # characters the identity is composed with, or is long enough that the composed identity exceeds MaximumIdentityLength.