IMail FolderFetch Async(IListInt 32, IFetch Request, Cancellation Token) Method
Asynchronously fetch the message summaries for the specified message indexes.
Definition
Namespace: MailKit
Assembly: MailKit (in MailKit.dll) Version: 5.0.0
An enumeration of summaries for the requested messages.
Assembly: MailKit (in MailKit.dll) Version: 5.0.0
C#
Task<IList<IMessageSummary>> FetchAsync(
IList<int> indexes,
IFetchRequest request,
CancellationToken cancellationToken = default
)Parameters
- indexes IListInt32
- The indexes.
- request IFetchRequest
- The fetch request.
- cancellationToken CancellationToken (Optional)
- The cancellation token.
Return Value
TaskIListIMessageSummaryAn enumeration of summaries for the requested messages.
Remarks
Asynchronously fetches the message summaries for the specified message indexes.
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.
Exceptions
| ArgumentNullException |
indexes is . -or- request is . |
| ArgumentException | One or more of the indexes is invalid. |
| 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. |