Click or drag to resize
MimeKit

MailFolderSortAsync(IListUniqueId, SearchQuery, IListOrderBy, CancellationToken) Method

Asynchronously sort messages matching the specified query.

Namespace: MailKit
Assembly: MailKit (in MailKit.dll) Version: 4.3.0
Syntax
C#
public virtual Task<IList<UniqueId>> SortAsync(
	IList<UniqueId> uids,
	SearchQuery query,
	IList<OrderBy> orderBy,
	CancellationToken cancellationToken = default
)

Parameters

uids  IListUniqueId
The subset of UIDs
query  SearchQuery
The search query.
orderBy  IListOrderBy
The sort order.
cancellationToken  CancellationToken  (Optional)
The cancellation token.

Return Value

TaskIListUniqueId
An array of matching UIDs in the specified sort order.

Implements

IMailFolderSortAsync(IListUniqueId, SearchQuery, IListOrderBy, CancellationToken)
Exceptions
ExceptionCondition
ArgumentNullException

uids is null.

-or-

query is null.

-or-

orderBy is null.

ArgumentException

uids is empty.

-or-

One or more of the uids is invalid.

-or-

orderBy is empty.

NotSupportedException

One or more search terms in the query are not supported.

-or-

The server does not support sorting search results.

ObjectDisposedException The IMailStore has been disposed.
ServiceNotConnectedException The IMailStore is not connected.
ServiceNotAuthenticatedException The IMailStore is not authenticated.
FolderNotOpenException The folder is not currently open.
OperationCanceledException The operation was canceled via the cancellation token.
IOException An I/O error occurred.
ProtocolException The server's response contained unexpected tokens.
CommandException The command failed.
Remarks
The returned array of unique identifiers will be sorted in the preferred order and can be used with GetMessage(UniqueId, CancellationToken, ITransferProgress).
See Also