IMailFolderAppendAsync(IListIAppendRequest, CancellationToken) Method

Asynchronously append multiple messages to the folder.

Definition

Namespace: MailKit
Assembly: MailKit (in MailKit.dll) Version: 5.0.0
C#
Task<IList<UniqueId>> AppendAsync(
	IList<IAppendRequest> requests,
	CancellationToken cancellationToken = default
)

Parameters

requests  IListIAppendRequest
The append requests.
cancellationToken  CancellationToken  (Optional)
The cancellation token.

Return Value

TaskIListUniqueId
The UID of the appended message, if available; otherwise, an empty array.

Remarks

Asynchronously appends multiple messages to the folder and returns the UniqueIds assigned to each of the messages.

Only the TransferProgress of the first request is used, and it reports the progress of the entire batch.

Exceptions

ArgumentNullException 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.

See Also