Imap FolderRename Method
Rename the folder to exist with a new name under a new parent folder.
Definition
Namespace: MailKit.Net.Imap
Assembly: MailKit (in MailKit.dll) Version: 5.0.0
IMailFolderRename(IMailFolder, String, CancellationToken)
Assembly: MailKit (in MailKit.dll) Version: 5.0.0
C#
public override void Rename(
IMailFolder parent,
string name,
CancellationToken cancellationToken = default
)Parameters
- parent IMailFolder
- The new parent folder.
- name String
- The new name of the folder.
- cancellationToken CancellationToken (Optional)
- The cancellation token.
Implements
IMailFolderRename(IMailFolder, String, CancellationToken)IMailFolderRename(IMailFolder, String, CancellationToken)
Remarks
Renames the folder to exist with a new name under a new parent folder.
Exceptions
| ArgumentNullException |
parent is . -or- name is . |
| ArgumentException |
parent does not belong to the ImapClient. -or- name is not a legal folder name. |
| ObjectDisposedException | The ImapClient has been disposed. |
| ServiceNotConnectedException | The ImapClient is not connected. |
| ServiceNotAuthenticatedException | The ImapClient is not authenticated. |
| FolderNotFoundException | The ImapFolder does not exist. |
| InvalidOperationException | The folder cannot be renamed (it is either a namespace or the Inbox). |
| 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. |