The MailboxName property returns the name of the currently
selected mailbox. If no mailbox has been selected by the client, this
property will return an empty string. This property is only valid
when connected to an IMAP server.
Setting the MailboxName property will select a new mailbox
in read-write mode. If the client has a different mailbox currently
selected, that mailbox will be closed and any messages marked for
deletion will be expunged. To prevent deleted messages from being
removed from the previous mailbox, call the UnselectMailbox
method prior to selecting the new mailbox. Setting the
MailboxName property to an empty string will cause the current
mailbox to be unselected, and a new mailbox will not be selected.
Before the application can access any messages, it must select a new
mailbox.
Selecting a new mailbox will automatically update those properties
which provide information about the current mailbox, such as the
MailboxFlags and MailboxUID properties. If an
application wishes to update the information for the current mailbox,
simply set the MailboxName property again with the same
mailbox name. Note that this will not cause any messages marked for
deletion to be expunged.
The special case-insensitive mailbox name INBOX is used for new
messages. Other mailbox names may or may not be case-sensitive
depending on the IMAP server's operating system and
implementation.
If the mailbox name contains international characters then it is
automatically encoded using a modified version of UTF-7 encoding. For
example, if a mailbox is named "Håndskrift", the mailbox
name created on the server will be the string
"H&AOU-ndskrift". The control will automatically decode
UTF-7 encoded mailbox names, making the conversion transparent to the
application.