Pop3DownloadMessageHeaders Method (Int32, Int32)
Downloads the header of each message in the specified range from the server.

Namespace: MailBee.Pop3Mail
Assembly: MailBee.NET (in MailBee.NET.dll) Version: 11.2.0 build 590 for .NET 4.5
Syntax
public MailMessageCollection DownloadMessageHeaders(
	int startIndex,
	int count
)

Parameters

startIndex
Type: SystemInt32
The ordinal position (in the inbox) of the first message in the range to be downloaded.
count
Type: SystemInt32
Number of messages to be downloaded, or -1 to indicate that all messages in the range startIndex to InboxMessageCount must be downloaded.

Return Value

Type: MailMessageCollection
On success, a MailMessageCollection object containing the downloaded message headers; otherwise, a null reference (Nothing in Visual Basic).
Exceptions
ExceptionCondition
MailBeeExceptionAn error occurred and ThrowExceptions is true.
Remarks
If the POP3 server supports pipelining, this method will download all the messages in a single network operation, which greatly increases performance and reduces network traffic.
Examples
This sample downloads headers of the last 10 messages in the mailbox, and displays the following information for each message:
  • Subject: field
  • Date and time when the message was created
  • Date and time when the message was delivered to the mailbox
The message information is displayed in descending order (from newer messages to older ones).
// 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).
Pop3 pop = new Pop3();
pop.Connect("mail.domain.com");
pop.Login("jdoe", "secret");

// Download headers of the last 10 messages.
MailMessageCollection msgs = pop.DownloadMessageHeaders(pop.InboxMessageCount - 9, 10);

// Reverse the order of the elements to make newer messages appear first in the collection.
msgs.Reverse();

// Display Date, DateReceived, and Subject.
foreach (MailMessage msg in msgs)
{
    Console.WriteLine("Message #" + msg.IndexOnServer + ", created at " + msg.Date + " and received at " + msg.DateReceived + ", has Subject: " + msg.Subject);
}

pop.Disconnect();
See Also