Pop3InboxPreloadOptions Enumeration |
Namespace: MailBee.Pop3Mail
Member name | Value | Description | |
---|---|---|---|
None | 0 | Do not preload any elements of mailbox statistics (lengths and Unique-ID's of messages). | |
List | 1 | After successful login, send LIST POP3 command and download the list of lengths of all messages in the mailbox. | |
Uidl | 2 | After successful login, send UIDL POP3 command and download the list of Unique-ID's of all messages in the mailbox. |
Normally (when None is used), MailBee automatically downloads mailbox statistics when required. For instance, if the application never calls any methods which operate with Unique-ID values (the methods like GetMessageUidFromIndex(Int32), UIDL POP3 command will never be issued. If, however, GetMessageUidFromIndex(Int32) gets called, MailBee will detect UIDL has not been issued yet, and then send this command to the server. If the developer does not want to rely on automatic download of mailbox statistics, the options provided by this enumeration can be used.
However, if you deal with large multi-megabyte e-mails, it's strongly recommended to set List flag in InboxPreloadOptions value prior to logging into a mailbox. This way MailBee will know the size of each e-mail before downloading and allocate the buffer of the required size at once. This will eliminate step-by-step memory reallocations during downloading a large e-mail.