Class MailboxQueryCursorFilterMismatchException

Namespace

MailFathom.Application.Emails.Mailboxes

Assembly

MailFathom.Application.dll

The failure raised when a continuation cursor was issued for a different query than the one presenting it.

public sealed class MailboxQueryCursorFilterMismatchException : MailFathomException, ISerializable

Inheritance

object

Exception

MailFathomException

MailboxQueryCursorFilterMismatchException

Implements

ISerializable

Inherited Members

Exception.GetBaseException()

Exception.GetType()

Exception.ToString()

Exception.Data

Exception.HelpLink

Exception.HResult

Exception.InnerException

Exception.Message

Exception.Source

Exception.StackTrace

Exception.TargetSite

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.ReferenceEquals(object, object)

Remarks

A keyset cursor names a position in one total order over one filtered set. Presented against a different filter or a different reading direction it still names a row, which is exactly why honoring it would be wrong: the caller would receive an arbitrary window of the new result set and would have no way to notice. The cursor therefore carries a fingerprint of the filters it was issued for, and a mismatch is refused.

Changing the page size is not a mismatch. It moves no boundary, so a client is free to ask for a larger or smaller page while continuing the same walk.

Constructors

MailboxQueryCursorFilterMismatchException()

Initializes the failure for one cursor presented against filters it was not issued for.

Properties

ErrorCode

Gets the stable code identifying this failure to a boundary that must report it without naming a type.