MailBee.NET Objects 3.1

Pop3.QuickDownloadMessage Method (String, String, String, Int32)

Completely downloads the specified message from the server, in a single line of code.

public static MailMessage QuickDownloadMessage(
   string serverName,
   string accountName,
   string password,
   int index
);

Parameters

serverName
The name or IP address of the POP3 server.
accountName
The user account name on the server.
password
The password of the user account on the server.
index
The ordinal position of the message in the inbox, starting at 1.

Return Value

A MailMessage object containing the downloaded message (including the header and all the body parts and attachments).

Remarks

This method does not delete any messages in the inbox.

The common use of this method is to quickly receive the message when its index in the inbox is already known. For instance, QuickDownloadMessages method was used to download headers for all messages in the inbox and build the message list where the user can click a particular message to view it completely. Once the user selected the message to be viewed, the application passes its index in the message list as a value of index parameter of QuickDownloadMessage method to download the selected message (if the message list index is zero-based, the developer should also add 1 to the index value).

Note   Static methods still require the valid license key be assigned to LicenseKey property (by either setting in in the code or in the config file such as app.config). All samples in MailBee documentation assume the license key is already set in the config file.

Exceptions

Exception TypeCondition
MailBeeExceptionAn error occurred.

Example

This sample downloads the first message in the inbox and saves it as .EML file to disk.

[C#]
// To use the code below, import MailBee namespaces at the top of your code.
using MailBee;
using MailBee.Pop3Mail;
using MailBee.Mime;

// The actual code (put it into a method of your class).
MailMessage msg = Pop3.QuickDownloadMessage("pop.server.com",
    "login", "password", 1);
msg.SaveMessage(@"C:\Temp\message.eml");
[Visual Basic]
' To use the code below, import MailBee namespaces at the top of your code.
Imports MailBee
Imports MailBee.Pop3Mail
Imports MailBee.Mime

' The actual code (put it into a method of your class).
Dim msg As MailMessage = Pop3.QuickDownloadMessage("pop.server.com", _
    "login", "password", 1)
msg.SaveMessage("C:\Temp\message.eml")

See Also

Pop3 Class | MailBee.Pop3Mail Namespace | Pop3.QuickDownloadMessage Overload List | QuickDownloadMessages