IMailFolderExtensionsFetchAsync(IMailFolder, IListUniqueId, UInt64, MessageSummaryItems, CancellationToken) Method

public static Task<IList<IMessageSummary>> FetchAsync(
	this IMailFolder folder,
	IList<UniqueId> uids,
	ulong modseq,
	MessageSummaryItems items,
	CancellationToken cancellationToken = default
)

Parameters

folder  IMailFolder

The folder.

uids  IListUniqueId

The UIDs.

modseq  UInt64

The mod-sequence value.

items  MessageSummaryItems

The message summary items to fetch.

cancellationToken  CancellationToken  (Optional)

The cancellation token.

Return Value

Usage Note

Asynchronously fetches the message summaries for the specified message UIDs that have a higher mod-sequence value than the one specified.

If the mail store supports quick resynchronization and the application has enabled this feature via EnableAsync(ImapFeatures, CancellationToken), then this method will emit MessagesVanished events for messages that have vanished since the specified mod-sequence value.

It should be noted that if another client has modified any message in the folder, the mail service may choose to return information that was not explicitly requested. It is therefore important to be prepared to handle both additional fields on a IMessageSummary for messages that were requested as well as summaries for messages that were not requested at all.

Reference