Method Rule

Namespace: MailFathom.Domain.Mutations

Assembly: MailFathom.Domain.dll

Rule(string, string)

Names a rule together with the revision of it that asked.

public static MailboxMutationRequester Rule(string ruleName, string revision)

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.

Returns

MailboxMutationRequester: A requester naming that revision of that rule.

Remarks

The revision is part of the identity rather than a column beside it, because the comparison that matters is equality of the whole thing: an edited rule is a different requester and asks again, while an unchanged one re-evaluated on every pass asks once. It is text rather than a counter because the revision a rule set is known by is a digest over its own declarations, which is what makes two instances reading one file agree on it.

Exceptions

ArgumentException: Thrown when ruleName or revision is blank, carries a control character, or is long enough that the composed identity exceeds MaximumIdentityLength.