Method FindByAddressAsync

Namespace

MailFathom.Application.Contacts

Assembly

MailFathom.Application.dll

FindByAddressAsync(EmailAddress, CancellationToken)

Reads the person who uses one address.

public Task<Contact?> FindByAddressAsync(EmailAddress address, CancellationToken cancellationToken)

Parameters

address EmailAddress

The address to resolve.

cancellationToken CancellationToken

Cancels the read.

Returns

Task<Contact>

The contact holding that address, or null when nobody in the book does.

Remarks

The lookup a caller reaches for once it has an address out of mail, answered from the unique index over the address comparison form rather than from a search over the book. At most one contact can answer, which is the book's own uniqueness rule rather than a property of this method.

Exceptions

PrincipalNotAuthorizedException

Thrown when the caller does not hold the reading grant.