Imap FolderAppend Async(Format Options, IAppend Request, Cancellation Token) Method
Asynchronously append a message to the folder.
Definition
Namespace: MailKit.Net.Imap
Assembly: MailKit (in MailKit.dll) Version: 5.0.0
The UID of the appended message, if available; otherwise, .
IMailFolderAppendAsync(FormatOptions, IAppendRequest, CancellationToken)
Assembly: MailKit (in MailKit.dll) Version: 5.0.0
C#
public override Task<UniqueId?> AppendAsync(
FormatOptions options,
IAppendRequest request,
CancellationToken cancellationToken = default
)Parameters
- options FormatOptions
- The formatting options.
- request IAppendRequest
- The append request.
- cancellationToken CancellationToken (Optional)
- The cancellation token.
Return Value
TaskNullableUniqueIdThe UID of the appended message, if available; otherwise, .
Implements
IMailFolderAppendAsync(FormatOptions, IAppendRequest, CancellationToken)IMailFolderAppendAsync(FormatOptions, IAppendRequest, CancellationToken)
Remarks
Asynchronously appends a message to the folder and returns the UniqueId assigned to the message.
Exceptions
| ArgumentNullException |
options is . -or- request is . |
| ObjectDisposedException | The ImapClient has been disposed. |
| ServiceNotConnectedException | The ImapClient is not connected. |
| ServiceNotAuthenticatedException | The ImapClient is not authenticated. |
| InvalidOperationException | Internationalized formatting was requested but has not been enabled. |
| FolderNotFoundException | The ImapFolder 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- The request included annotations but the folder does not support annotations. |
| IOException | An I/O error occurred. |
| ImapProtocolException | The server's response contained unexpected tokens. |
| ImapCommandException | The server replied with a NO or BAD response. |