ImapFolderCopyTo(IListUniqueId, ICopyRequest, CancellationToken) Method

Copy the specified messages to the destination folder.

Definition

Namespace: MailKit.Net.Imap
Assembly: MailKit (in MailKit.dll) Version: 5.0.0
C#
public override UniqueIdMap CopyTo(
	IList<UniqueId> uids,
	ICopyRequest request,
	CancellationToken cancellationToken = default
)

Parameters

uids  IListUniqueId
The UIDs of the messages to copy.
request  ICopyRequest
The copy request.
cancellationToken  CancellationToken  (Optional)
The cancellation token.

Return Value

UniqueIdMap
The UID mapping of the messages in the destination folder, if available; otherwise an empty mapping.

Implements

IMailFolderCopyTo(IListUniqueId, ICopyRequest, CancellationToken)
IMailFolderCopyTo(IListUniqueId, ICopyRequest, CancellationToken)

Remarks

Copies the specified messages to the destination folder.

Exceptions

ArgumentNullException

uids is .

-or-

request is .

ArgumentException

One or more of the uids is invalid.

-or-

The Destination folder does not belong to the ImapClient.

ObjectDisposedException The ImapClient has been disposed.
ServiceNotConnectedException The ImapClient is not connected.
ServiceNotAuthenticatedException The ImapClient is not authenticated.
FolderNotFoundException The Destination folder does not exist.
FolderNotOpenException The ImapFolder is not currently open.
NotSupportedException The IMAP server does not support the UIDPLUS extension.
OperationCanceledException The operation was canceled via the cancellation token.
IOException An I/O error occurred.
ImapProtocolException The server's response contained unexpected tokens.
ImapCommandException The server replied with a NO or BAD response.

See Also