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

DBX Parser

, 2 Jul 2009 CPOL
Rate this:
Please Sign up or sign in to vote.
Read Outlook Express DBX file, extract mail to EML file


The DBXParser can read an Outlook Express DBX file, and extract the raw content (MIME) to EML file, then you can use MIME parsers to get the actual subject body and attachments. It's the first and only (as far as Google tells) pure C# source code that provides simple methods to read and extract, free, pure, without over-headed third-party DLLs. Wink | ;)


I've been searching for source code to read an Outlook Express DBX file for a very long time (believe me, it's really long). I have found quite a few DBX readers/codes in other languages, such as:

But none of them are pure C#, so I made my own. It's a good way to port similar codes from another language, here I choose the DBX Parser(PHP), because it's much simpler than the C++ versionSmile | :)

Where Are My DBX Files?

Your DBX files will normally be found here:

C:\Documents and Settings\{UserName}\Local Settings\
	Application Data\Identities\{Guid}\Microsoft\Outlook Express 

Take a look at {Guid}, it's different on different computers, so all you need to do is to use Directory.GetFiles() to go through all the sub folders for searching *.dbx files.

File Format

I am not going to go deep into the file format here, because there are already quite a few documents there:

How It Works

It reads the raw DBX file, without any third-party or related DLLs provided by Outlook Express. It only reads through the file, decoding byte by byte, then internally stores the position and sizes of chunks of each message in order to be used by the Extract method, because it only stores the positions, so it uses very little memory.

Using the Code

First create a new instance of DBX, then use the Parse function to read the file, it will return how many messages the DBX file contains. If it returns -1, then it means there is something wrong with the file. Then you could use the Extract method to save the content to a file or to read the content to memory.

Here goes a sample code:

using (DBX DBX = new DBX())
    int count = DBX.Parse(@"test.dbx");	//specify your DBX file here
    if (count > 0)
        for (int i = 0; i < count; i++)
            DBX.Extract(i, (i + 1) + ".eml"); //specify file to extract to
            				//or just read the content to memory
            				//string content = DBX.Extract(i);

How to Decode MIME (EML File)?

Choose any one of the following codes that you like:

Points of Interest

Because I suffered a lot while finding such code, I contribute it here as others won't have to get crazy looking for it. After porting the code from PHP, I feel that PHP is really mature. There are different kinds of PHP codes out there, and I'm really surprised to see that even PHP has such a sample code, but Java/VB/C# do not. I try to keep this code as simple as possible, read and extract, that's all, which I think fits most of the situations. If you have any comments or suggestions, please feel free to tell me, or just modify the code yourself.


  • Version 1.0 - 2009-5-1
  • Version 1.1 - 2009-5-5: some code clean up, added a VC++ code
  • Version 1.2 - 2009-7-2: fixed a problem not correctly return the exact amount of mails in some special situations, thanks to Cato.


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


About the Author

Huisheng Chen
Technical Lead
Australia Australia
I was born in the south of China, started to write GWBASIC code since 1993 when I was 13 years old, with professional .net(c#) and vb, founder of

Now I am living in Sydney, Australia.
Follow on   Twitter   LinkedIn

Comments and Discussions

GeneralMy vote of 5 PinmemberSunny_Kumar_16-Jul-14 2:25 
BugIt gives wrong count (skips some emails from DBX) if the body value is null Pinmemberzhitesh1-Mar-12 6:36 
GeneralRe: It gives wrong count (skips some emails from DBX) if the body value is null PinmemberHuisheng Chen1-Mar-12 11:34 
GeneralMy vote of 5 Pinmemberklinkenbecker18-Jun-11 8:20 
GeneralOrder of files PinmemberMacRaider410-Feb-10 6:23 
GeneralEmail count always -1 Pinmembermhota30-Nov-09 21:18 
GeneralRe: Email count always -1 PinmemberUnruled Boy30-Nov-09 21:55 
GeneralRe: Email count always -1 PinmemberMember 109748307-Aug-14 22:04 
Generaldbx error PinmemberPeso19-Aug-09 23:25 
GeneralRe: dbx error PinmemberUnruled Boy20-Aug-09 0:43 
GeneralMy vote of 1 Pinmemberabcd1234f10-Aug-09 9:37 
GeneralThank you PinmemberPepsibot22-Jul-09 14:08 
Generalnice Pinmemberpita20002-Jul-09 22:37 
GeneralRe: nice PinmemberUnruled Boy3-Jul-09 0:20 
QuestionIs it Extract only 10 Mails ? PinmemberLaxmilal Menaria30-Jun-09 22:15 
AnswerRe: Is it Extract only 10 Mails ? PinmemberUnruled Boy30-Jun-09 22:23 
AnswerRe: Is it Extract only 10 Mails ? PinmemberUnruled Boy2-Jul-09 16:52 
QuestionHow is it? Pinmembersjun127-May-09 17:15 
GeneralRe: How is it? PinmemberUnruled Boy30-May-09 1:01 
GeneralGreat! PinmemberSouthmountain1-May-09 7:11 
GeneralRe: Great! PinmemberUnruled Boy1-May-09 17:46 
Generalplease give comment or suggestions PinmemberUnruled Boy1-May-09 5:20 
GeneralUnveil ... Pinmemberkanu@adatapost1-May-09 0:26 
GeneralRe: Unveil ... PinmemberUnruled Boy1-May-09 5:19 

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 | Terms of Use | Mobile
Web03 | 2.8.150331.1 | Last Updated 2 Jul 2009
Article Copyright 2009 by Huisheng Chen
Everything else Copyright © CodeProject, 1999-2015
Layout: fixed | fluid