Click or drag to resize
MimeKit

ImapFolderAppendAsync(FormatOptions, IAppendRequest, CancellationToken) Method

Asynchronously append a message to the folder.

Namespace: MailKit.Net.Imap
Assembly: MailKit (in MailKit.dll) Version: 4.3.0
Syntax
C#
Copy
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

TaskNullableUniqueId
The UID of the appended message, if available; otherwise, null.

Implements

IMailFolderAppendAsync(FormatOptions, IAppendRequest, CancellationToken)
IMailFolderAppendAsync(FormatOptions, IAppendRequest, CancellationToken)
Exceptions
ExceptionCondition
ArgumentNullException

options is null.

-or-

request is null.

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.
Remarks
Asynchronously appends a message to the folder and returns the UniqueId assigned to the message.
See Also