Click here to Skip to main content
15,881,882 members
Articles / Web Development / ASP.NET
Article

Sending the contents of a webpage with images as an HTML mail

Rate me:
Please Sign up or sign in to vote.
4.72/5 (22 votes)
23 Dec 20062 min read 146.2K   2.2K   73   36
This article shows how you can embed images from a web server into your mail message.

Introduction

Some time ago, I had written an ASP.NET website showing some reports generated from a database. The reports contained tables, as well as dynamically generated graphs. To get a larger number of people to read the reports, it seemed like a good idea to send them as a weekly email newsletter. To be able to re-read the newsletter in a later stage, it was necessary to include the images, since they are changing over time. Embedding the images makes it also possible to send the mail to people that do not have access to the website.

This article shows a way to retrieve images from a web server and embed them into your email message.

Usage

This is how you can send a web page with the mailer class provided in this article:

C#
// The contents that will be sent
Uri uri = new Uri("http://about.com/");

// Configuration of the email message
Fmd.Mail.WebpageMailer mailer = new Fmd.Mail.WebpageMailer();
mailer.SmtpServerName = "mail.somesmptserver.com";
mailer.Delay = 0;
mailer.MailMessage.From = new MailAddress("noreply@somedomain.com");
mailer.MailMessage.To.Add(new MailAddress("recipient@somedomain.com"));
mailer.MailMessage.Subject = "Automatic Mail Message " + 
                             DateTime.Now.ToShortDateString();
mailer.MailMessage.Priority = MailPriority.Normal;

// Sending the webpage
mailer.SendMailMessage(uri);

The main methods of the class

Sending the mail message

SendMailMessage is the main method in the class. It retrieves the contents of the web page to be sent. Next, it retrieves the images to embed. These parts are inserted into a mail message which is sent in the end.

C#
public void SendMailMessage(Uri uri)
{
    // Retrieve the contents
    string htmlbody = GetBody(uri);
    
    // See what images there are to embed
    string modifiedbody;            
    List<linkedResource> foundResources;
    ExtractLinkedResources(uri, htmlbody, out modifiedbody, 
                           out foundResources);
    
    // Write the html to a memory stream
    MemoryStream stream = new MemoryStream();
    byte[] bytes = System.Text.Encoding.ASCII.GetBytes(modifiedbody);
    stream.Write(bytes, 0, bytes.Length);            
    stream.Position = 0;

    // Configure the mail so it contains the html page
    _mailMessage.Body = "This is a html mail - use an" + 
                        " email client that can read it";
    AlternateView altView = new AlternateView(stream, 
                  System.Net.Mime.MediaTypeNames.Text.Html);

    // Embed the images into the mail
    foreach (LinkedResource linkedResource in foundResources)
    {
        altView.LinkedResources.Add(linkedResource);
    }
    _mailMessage.AlternateViews.Add(altView);
    
    // Send the mail
    SmtpClient client = new SmtpClient(_smptServerName);
    client.Send(_mailMessage);
}

Filling the LinkedResource

This code snippet from ExtractLinkedResources shows how the images are embedded:

C#
// Fill the linked resource
LinkedResource data = new LinkedResource(imageStream);

// Determine a name and set the media type of the linked resource
string generatedName = null;
if (contentType.ToLower().IndexOf("image/gif") >= 0)
{
    data.ContentType.MediaType = System.Net.Mime.MediaTypeNames.Image.Gif;
    generatedName = "image" + imageID.ToString() + ".gif";
}
else if (contentType.ToLower().IndexOf("image/jpeg") >= 0)
{
    data.ContentType.MediaType = System.Net.Mime.MediaTypeNames.Image.Jpeg;
    generatedName = "image" + imageID.ToString() + ".jpeg";
}

// it is something that I don't handle yet
if (generatedName == null)
    continue;

// Generate the linked resource for the image being embedded
string generatedSrc = "cid:" + generatedName;
data.ContentType.Name = generatedName;
data.ContentId = generatedName;
data.ContentLink = new Uri(generatedSrc);
linkedResources.Add(data); 

Getting a web page

This downloads the HTML contents:

C#
public static string GetBody(Uri uri)
{
    HttpWebRequest request = (HttpWebRequest)WebRequest.Create(uri);
    
    // Set some reasonable limits on resources used by this request
    request.MaximumAutomaticRedirections = 4;
    request.MaximumResponseHeadersLength = 4;
    // Set credentials to use for this request.
    request.Credentials = CredentialCache.DefaultCredentials;
    HttpWebResponse response = (HttpWebResponse)request.GetResponse();
    
    // Get the stream associated with the response.
    Stream receiveStream = response.GetResponseStream();

    // Pipes the stream to a higher level stream reader
    // with the required encoding format. 
    StreamReader readStream = new StreamReader(receiveStream, Encoding.UTF8);

    string body = readStream.ReadToEnd();
    readStream.Close();

    response.Close();
    return body;
}

Glueing everything together

To make everything work together, there are a few things that need to be tackled. Since the images may be in some virtual directory on the web server, different from the page itself, their relative paths need to be changed. The program follows these steps to get everything together:

  1. Read the HTML body
  2. Analyze the HTML body to extract what images need to be retrieved
  3. Download the images, and make them available as a MemoryStream to embed into the mail message
  4. Modify the HTML so the image URLs are relative to the mail message instead of being relative to the web page
  5. Put everything into the mail message and send it away

Final remarks

This article can do two things for you. It can get you started when you want to send web pages as an email message, and the sample code may help you when you are struggling on how to embed images into a mail message. I hope you find it useful!

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


Written By
Team Leader
Netherlands Netherlands
My education was Mathematics (with a statistics final). I was one of the six teammembers of the dutch IMO team in 93.

Since 97 I have been working as developer of software for professional traders. In the beginning of my carreer I used mainly C++ and MFC, later on C# began playing a more significant role.

In the last years, I have gotten more management responsabilities, which also increased my interest in teaching computer science to junior developers.

Comments and Discussions

 
AnswerRe: How to save/edit the email Pin
Five Minute Developer23-Jan-07 2:33
Five Minute Developer23-Jan-07 2:33 
QuestionHow can it have SMTP basic athentication? Pin
cornejoserrano5-Jan-07 1:22
cornejoserrano5-Jan-07 1:22 
AnswerRe: How can it have SMTP basic athentication? Pin
Five Minute Developer5-Jan-07 10:18
Five Minute Developer5-Jan-07 10:18 
AnswerRe: How can it have SMTP basic athentication? Pin
cooldirtyboy23-Oct-07 20:27
cooldirtyboy23-Oct-07 20:27 
AnswerRe: How can it have SMTP basic athentication? Pin
muhammedsimsek14-May-08 1:10
muhammedsimsek14-May-08 1:10 
Generalcool Pin
Magician_Oz28-Dec-06 11:37
Magician_Oz28-Dec-06 11:37 
GeneralRe: cool Pin
Five Minute Developer5-Jan-07 10:06
Five Minute Developer5-Jan-07 10:06 
GeneralThanks ! Pin
NinjaCross28-Dec-06 1:10
NinjaCross28-Dec-06 1:10 
Really interesting solution, thanks for posting Big Grin | :-D
What about embedding SWF/MPG/JavaScript contents ?

--
NinjaCross
www.ninjacross.com

AnswerRe: Thanks ! Pin
Five Minute Developer28-Dec-06 9:01
Five Minute Developer28-Dec-06 9:01 
GeneralRe: Thanks ! Pin
NinjaCross30-Dec-06 7:03
NinjaCross30-Dec-06 7:03 
GeneralServer.Execute Pin
Gabe Wishnie23-Dec-06 8:50
Gabe Wishnie23-Dec-06 8:50 
GeneralRe: Server.Execute Pin
Five Minute Developer24-Dec-06 0:16
Five Minute Developer24-Dec-06 0:16 

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

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