Click or drag to resize
MimeKit

MailFolderAppend(FormatOptions, IAppendRequest, CancellationToken) Method

Append a message to the folder.

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

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

Implements

IMailFolderAppend(FormatOptions, IAppendRequest, CancellationToken)
Exceptions
ExceptionCondition
ArgumentNullException

options is null.

-or-

request 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-

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