Mail FolderAppend Async(Format Options, IListIAppend Request, Cancellation Token) Method
Asynchronously append multiple messages to the folder.
Definition
Namespace: MailKit
Assembly: MailKit (in MailKit.dll) Version: 5.0.0
The UIDs of the appended messages, if available; otherwise an empty array.
Assembly: MailKit (in MailKit.dll) Version: 5.0.0
C#
public abstract Task<IList<UniqueId>> AppendAsync(
FormatOptions options,
IList<IAppendRequest> requests,
CancellationToken cancellationToken = default
)Parameters
- options FormatOptions
- The formatting options.
- requests IListIAppendRequest
- The append requests.
- cancellationToken CancellationToken (Optional)
- The cancellation token.
Return Value
TaskIListUniqueIdThe UIDs of the appended messages, if available; otherwise an empty array.
Implements
IMailFolderAppendAsync(FormatOptions, IListIAppendRequest, CancellationToken)Remarks
Asynchronously appends multiple messages to the folder and returns the UniqueIds assigned to the messages.
Only the TransferProgress of the first request is used, and it reports the progress of the entire batch.
Exceptions
| ArgumentNullException |
options is . -or- requests is . |
| ArgumentException | One or more of the requests is . |
| ObjectDisposedException | The IMailStore has been disposed. |
| ServiceNotConnectedException | The IMailStore is not connected. |
| ServiceNotAuthenticatedException | The IMailStore is not authenticated. |
| InvalidOperationException | Internationalized formatting was requested but has not been enabled. |
| FolderNotFoundException | The MailFolder does not exist. |
| OperationCanceledException | The operation was canceled via the cancellation token. |
| NotSupportedException |
Internationalized formatting was requested but is not supported by the server. -or- One ore more requests included annotations but the folder does not support annotations. |
| IOException | An I/O error occurred. |
| ProtocolException | The server's response contained unexpected tokens. |
| CommandException | The command failed. |