Click or drag to resize
MimeKit

MailFolderThreadAsync(IListUniqueId, ThreadingAlgorithm, SearchQuery, CancellationToken) Method

Asynchronously thread the messages in the folder that match the search query using the specified threading algorithm.

Namespace: MailKit
Assembly: MailKit (in MailKit.dll) Version: 4.3.0
Syntax
C#
public abstract Task<IList<MessageThread>> ThreadAsync(
	IList<UniqueId> uids,
	ThreadingAlgorithm algorithm,
	SearchQuery query,
	CancellationToken cancellationToken = default
)

Parameters

uids  IListUniqueId
The subset of UIDs
algorithm  ThreadingAlgorithm
The threading algorithm to use.
query  SearchQuery
The search query.
cancellationToken  CancellationToken  (Optional)
The cancellation token.

Return Value

TaskIListMessageThread
An array of message threads.

Implements

IMailFolderThreadAsync(IListUniqueId, ThreadingAlgorithm, SearchQuery, CancellationToken)
Exceptions
ExceptionCondition
ArgumentOutOfRangeExceptionalgorithm is not supported.
ArgumentNullException

uids is null.

-or-

query is null.

ArgumentException

uids is empty.

-or-

One or more of the uids is invalid.

NotSupportedException

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

-or-

The server does not support threading 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
See Also