Pop3InboxPreloadOptions Enumeration
Specifies which elements of the mailbox statistics to download immediately after successful logging in the mailbox.

Namespace: MailBee.Pop3Mail
Assembly: MailBee.NET (in MailBee.NET.dll) Version: 12.4 build 677 for .NET 4.5
public enum Pop3InboxPreloadOptions
  Member nameValueDescription
None0 Do not preload any elements of mailbox statistics (lengths and Unique-ID's of messages).
List1 After successful login, send LIST POP3 command and download the list of lengths of all messages in the mailbox.
Uidl2 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.

See Also