Click here to Skip to main content
Click here to Skip to main content

Retrieving Mail with POP3

, 2 Jul 2005
Rate this:
Please Sign up or sign in to vote.
In this article I will demonstrate how to quickly and easily retrieve mail messages using the POP3 protocol.

Introduction

In this article, I will demonstrate how to quickly and easily retrieve mail messages using the POP3 protocol.

Why Console?

The demo code is a console application. For simple code snippets, I prefer console applications as they are easy to write and focus on the code without the demo being over shadowed by the interface code. All of the code demonstrated here can of course be used in Win Forms, Web Forms, Web service or any other type of applications.

What is Indy?

This demo uses classes from the open source library Indy.Sockets. Indy.Sockets is an open source socket library that supports clients, servers, TCP, UDP, raw sockets, as well as over 100 higher level protocols such as SMTP, POP3, NNTP, HTTP and many more. Indy.Sockets is available for C#, C++, Delphi, Visual Basic. NET, or any .NET language, and Kylix.

The code

try {
    // You will need to set these to your settings.
    // The settings here are settings for a local 
    // demo POP3 server
    // that I use for testing.
    string xHost = "127.0.0.1";
    string xUsername = "chad";
    string xPassword = "pass"; 
    using (POP3 xPOP3 = new POP3()) {
        xPOP3.Username = xUsername;
        xPOP3.Password = xPassword;
        xPOP3.Connect(xHost); 
        int xCount = xPOP3.CheckMessages();
        if (xCount == 0) {
            Console.WriteLine("No messages on account.");
        } 
        else {
            Message xMsg = new Message();
            xPOP3.Retrieve(1, xMsg);
            Console.WriteLine("Subject: " + xMsg.Subject);
            Console.WriteLine("From: " + xMsg.From.Text);
            Console.WriteLine("To: " + xMsg.Recipients[0].Text);
            Console.WriteLine();
            Console.WriteLine(xMsg.Body.Text);
        }
        try {
        } 
        finally {
            xPOP3.Disconnect();
        }
    }
} 
catch (Exception e) {
    Console.WriteLine(e.Message);
}
Console.WriteLine("");
Console.WriteLine("Press enter");
Console.ReadLine();

The code is very simple. The POP3 server is connected by using the host, username and the password provided. The CheckMessages method is called to obtain the number of messages in the mailbox. If at least one message exists, the first message is retrieved. Note the use of the Message class this is a special container that parses the mail message and its headers for easy access by the developer. Note the explicit use of the Disconnect method. In TCP protocols it's good to explicitly disconnect and with the POP3 protocol it is especially important as POP3 is transactional. Failing to call Disconnect will cause the POP3 server to rollback any messages deleted during the connection.

Running the demo

It is important to change these lines:

string xHost = "127.0.0.1";
string xUsername = "chad";
string xPassword = "pass";

You need to fill in these with the settings for your POP3 server.

Output

Running the demo will produce an output similar to this, if you have a message in your mailbox:

Subject: Hello
From: chad@test.com
To: chad@local.net

Hello, this is a test message.

Press enter.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

About the Author

Chad Z. Hower, a.k.a. Kudzu
"Programming is an art form that fights back"
www.KudzuWorld.com
 
Formerly the Regional Developer Adviser (DPE) for Microsoft Middle East and Africa, he was responsible for 85 countries spanning 4 continents and 10 time zones. Now Chad is a Microsoft MVP.
 
Chad is the chair of several popular open source projects including Indy and Cosmos (C# Open Source Managed Operating System).
 
Chad is the author of the book Indy in Depth and has contributed to several other books on network communications and general programming.
 
Chad has lived in Canada, Cyprus, Switzerland, France, Jordan, Russia, Turkey, and the United States. Chad has visited more than 60 countries, visiting most of them several times.

Comments and Discussions

 
GeneralAbout downloading attached file to mail Pinmemberfriendprach8-Oct-09 19:45 
GeneralPlease I need your Help Pinmembervampraider126-Feb-09 14:25 
QuestionUnable to log on PinmemberMember 310841713-Dec-08 8:06 
AnswerRe: Unable to log on PinmemberChad Z. Hower aka Kudzu13-Dec-08 13:00 
QuestionNO Connection Could Be Made Because the Target Machine Actively Refused It Pinmemberoerslaafroze27-Nov-07 5:37 
GeneralMIME Format PinmemberAlan (Engeman)21-Sep-07 0:50 
QuestionAmbiguous reference Pinmembertheplayer0123-Aug-07 11:33 
AnswerRe: Ambiguous reference PinmemberChad Z. Hower aka Kudzu26-Aug-07 10:23 
QuestionNeed Help Pinmemberkanzz2-Aug-07 19:48 
GeneralSample for actual release of Indy.Sockets Pinmembertim.taylor16-Jul-07 2:51 
GeneralMessage body is blank PinmemberPaolo Ramos29-Nov-06 6:18 
GeneralRe: Message body is blank PinmemberChad Z. Hower aka Kudzu29-Nov-06 7:52 
GeneralRe: Message body is blank PinmemberMember 390536329-Nov-08 5:45 
QuestionMessage Dates Pinmemberecs.dp29-Aug-06 4:50 
AnswerRe: Message Dates Pinmemberghiutzu25-Aug-08 2:37 
GeneralSSL PinmemberAMGG6-Aug-06 23:13 
GeneralRe: SSL PinmemberChad Z. Hower aka Kudzu7-Aug-06 23:45 
GeneralRe: SSL PinmemberNiladri Mahapatra9-Apr-07 20:43 
GeneralRe: SSL PinmemberDaniiiii24-Sep-12 21:44 
GeneralRe: SSL Pinmemberalgoram7-Jul-14 0:09 
GeneralRe: SSL PinpremiumChad Z. Hower aka Kudzu7-Jul-14 4:17 
GeneralRe: SSL Pinmemberalgoram7-Jul-14 5:16 
GeneralRe: SSL PinpremiumChad Z. Hower aka Kudzu7-Jul-14 5:18 
GeneralRe: SSL Pinmemberalgoram7-Jul-14 5:22 
GeneralRe: SSL PinpremiumChad Z. Hower aka Kudzu7-Jul-14 5:25 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Mobile
Web04 | 2.8.140718.1 | Last Updated 2 Jul 2005
Article Copyright 2005 by Chad Z. Hower aka Kudzu
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid