Click or drag to resize
MimeKit

ImapFolderAppendAsync(FormatOptions, IListIAppendRequest, CancellationToken) Method

Asynchronously append multiple messages to the folder.

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

TaskIListUniqueId
The UIDs of the appended messages, if available; otherwise an empty array.

Implements

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

options is null.

-or-

requests is null.

ArgumentException One or more of the requests 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-

One ore more requests 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 multiple messages to the folder and returns the UniqueIds assigned to the messages.
See Also