Click or drag to resize
MimeKit

MailFolderSearchAsync(SearchOptions, IListUniqueId, SearchQuery, CancellationToken) Method

Asynchronously search the subset of UIDs in the folder for messages matching the specified query.

Namespace: MailKit
Assembly: MailKit (in MailKit.dll) Version: 4.7.1
Syntax
C#
Copy
public virtual Task<SearchResults> SearchAsync(
	SearchOptions options,
	IList<UniqueId> uids,
	SearchQuery query,
	CancellationToken cancellationToken = default
)

Parameters

options  SearchOptions
The search options.
uids  IListUniqueId
The subset of UIDs
query  SearchQuery
The search query.
cancellationToken  CancellationToken  (Optional)
The cancellation token.

Return Value

TaskSearchResults
The search results.

Implements

IMailFolderSearchAsync(SearchOptions, IListUniqueId, SearchQuery, CancellationToken)
Exceptions
ExceptionCondition
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 the specified search options.

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
Asynchronously searches the fsubset of UIDs in the folder for messages matching the specified query, returning only the specified search results.
See Also