IFetchRequestPartialRange Property

Get or set the partial range of messages to fetch.

Definition

Namespace: MailKit
Assembly: MailKit (in MailKit.dll) Version: 5.0.0
C#
PartialRange? PartialRange { get; set; }

Property Value

NullablePartialRange
The partial range of messages to fetch.

Remarks

Gets or sets the partial range of messages to fetch.

If this property is set, the results returned by Fetch(IListUniqueId, IFetchRequest, CancellationToken) or FetchAsync(IListUniqueId, IFetchRequest, CancellationToken) will only include the message summaries for the specified range of messages. Positive positions within the range are relative to the oldest message in the set of unique identifiers while negative positions are relative to the newest message. For example, a range of -1:-100 will fetch the requested items for the newest 100 messages in the set.

This property is useful when the set of unique identifiers references an unknown number of messages, such as a UniqueIdRange that spans unknown or expunged unique identifiers.

  Note

This feature is only supported by IMAP servers that advertise support for the PARTIAL extension and can only be used when fetching messages by unique identifiers.

See Also