ImapFolderCreate(String, IEnumerableSpecialFolder, CancellationToken) Method

Create a new subfolder with the given name.

Namespace: MailKit.Net.Imap
Assembly: MailKit (in MailKit.dll) Version: 4.7.1

Syntax

public override IMailFolder Create(
	string name,
	IEnumerable<SpecialFolder> specialUses,
	CancellationToken cancellationToken = default
)

name String: The name of the folder to create.
specialUses IEnumerableSpecialFolder: A list of special uses for the folder being created.
cancellationToken CancellationToken (Optional): The cancellation token.

IMailFolder
The created folder.

Exceptions

Exception	Condition
ArgumentNullException	name is null. -or- specialUses is null.
ArgumentException	name is empty.
ObjectDisposedException	The ImapClient has been disposed.
ServiceNotConnectedException	The ImapClient is not connected.
ServiceNotAuthenticatedException	The ImapClient is not authenticated.
InvalidOperationException	The DirectorySeparator is nil, and thus child folders cannot be created.
NotSupportedException	The IMAP server does not support the CREATE-SPECIAL-USE 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.

Remarks

Creates a new subfolder with the given name.