Click or drag to resize
MimeKit

MailFolderAppend(FormatOptions, IListIAppendRequest, CancellationToken) Method

Append multiple messages to the folder.

Namespace: MailKit
Assembly: MailKit (in MailKit.dll) Version: 4.7.1
Syntax
C#
Copy
public abstract IList<UniqueId> Append(
	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

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

Implements

IMailFolderAppend(FormatOptions, IListIAppendRequest, CancellationToken)
Exceptions
ExceptionCondition
ArgumentNullException

options is null.

-or-

requests is null.

ArgumentException One or more of the requests is null.
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.
Remarks
Appends multiple messages to the folder and returns the UniqueIds assigned to the messages.
See Also