MailFolderThread(ThreadingAlgorithm, SearchQuery, CancellationToken) Method

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.12.1

Syntax

public abstract IList<MessageThread> Thread(
	ThreadingAlgorithm algorithm,
	SearchQuery query,
	CancellationToken cancellationToken = default
)

IListMessageThread
An array of message threads.

Exceptions

Exception	Condition
ArgumentOutOfRangeException	algorithm is not supported.
ArgumentNullException	query is .
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

The UniqueId can be used with methods such as GetMessage(UniqueId, CancellationToken, ITransferProgress).