Click here to Skip to main content
15,312,747 members
Articles / Web Development / ASP.NET
Posted 25 Sep 2013


56 bookmarked

Scraping HTML DOM elements using HtmlAgilityPack (HAP) in ASP.NET

Rate me:
Please Sign up or sign in to vote.
4.81/5 (30 votes)
6 Jan 2014CPOL4 min read
Scrap/Parse the DOM elements of a website.

Introduction (What is screen scraping?)

To parse HTML from a website is otherwise called Screen Scraping. It’s a process to access external website information (the information must be public – public data) and processing it as required. For instance, if we want to get the average ratings of Nokia Lumia 1020 from different websites we can scrap the ratings from all the websites and calculate the average in our code. So we can say, as a general “User” what you can have as “Public Data”, you’ll be able to scrap that using HTML Agility Pack easily. 


Previously it was harder to scrap a website as the hold DOM elements used to be downloaded as string. So it wasn't a pleasure to work with strings and find out individual nodes by iterating through at and matching tags and attributes to specify your requirements. Gradually the way has improved and now it has become too easy using HtmlAgilityPack library. That's why this article will give you a simple demonstration on how to start with HAP.

You need to have the basics of programming and must know writing code in C# and ASP.NET.  

How it works

Before HTML Agility Pack we had to use different built-in classes in .NET Framework to pull out HTML from a website. But now we don’t have to use such loads of classes rather we’ll use the HAP library and order it to do the task for us.

It’s pretty simple. Your code will make an HTTP request to the server and parse/store the returned HTML. 

First HAP creates a DOM view of the parsed HTML of a particular website. Then it’s really some lines of code that will allow you to pass through the DOM, selecting nodes as you like. Using an XPath expression, HAP also can give you a specific node and its attributes. HAP also includes a class to download a remote website.

Let's get started

In this example we'll parse all the links of a particular webpage and display it in our webpage using HtmlAgilityPack. So let's start:

  1. Run Visual Studio 2012
  2. Go to File -> New -> Project, select Web from Visual C# template and on right side select ASP.NET Empty Web Application. Name the Application HTMLAgilityPackStartUp and click OK.
  3. Image 1

    Image 2

  4. From Solution Explorer right click on References that’s within your project. And click on Manage Nuget Packages.
  5. Image 3

  6. Manage Nuget Packages window will appear. Click on the search bar on right side and search for HtmlAgilityPack. It’ll give you the libraries and extensions related to this name. On Middle tab of the window you’ll find HtmlAgilityPack library on first row. Click Install. It’ll download and install the library in your project and after finishing installation click OK.
  7. Image 4

    Check if the library has been added to the References.

    Image 5

  8. Now let's take a new Web Form and Name it MyScraper.aspx and click Add.
  9. Image 6

  10. We’ll edit the MyScraper.aspx file as follows taking some labels, a textbox and a button and Save it. 
  11. C#
    <%@ Page Language="C#" AutoEventWireup="true" CodeBehind="MyScraper.aspx.cs" Inherits="HTMLAgilityPackStartUp.MyScraper" %> 
    <!DOCTYPE html> 
    <html xmlns=""> 
       <head runat="server"> <title></title> 
          <form id="form1" runat="server"> 
    	    <asp:Label ID="InputHereLabel" runat="server" Text="Input Here" /> 
    	    <asp:TextBox ID="InputTextBox" runat="server" /> <br /> 
    	    <asp:Button ID="ClickMeButton" runat="server" Text="Click Me" OnClick="ClickMeButton_Click" /> <br /> <br /> 
                <asp:Label ID="OutputLabel" runat="server" /> 

  12. Switch to the Design view of MyScraper.aspx page, click on the ClickMeButton Button, press f4 to switch to the properties window and click on the Events tab and then double click on the Click Action. It’ll create a handler on MyScraper.aspx.cs.
  13. Image 7

  14. Now as we want to get all the links of a particular page of a website. To do that add the following using statement using HtmlAgilityPack; inside MyScraper.aspx.cs page and update the ClickMeButton_Click handler as follows: 
  15. C#
    using System;
    using System.Collections.Generic;
    using System.Linq;
    using System.Web;
    using System.Web.UI;
    using System.Web.UI.WebControls;
    using HtmlAgilityPack; 
    namespace HTMLAgilityPackStartUp
       public partial class MyScraper : System.Web.UI.Page
          protected void Page_Load(object sender, EventArgs e)
          protected void ClickMeButton_Click(object sender, EventArgs e)
    	 var getHtmlWeb = new HtmlWeb();
    	 var document = getHtmlWeb.Load(InputTextBox.Text);
    	 var aTags = document.DocumentNode.SelectNodes("//a");
    	 int counter = 1;
    	 if (aTags != null)
    		 foreach (var aTag in aTags)
    		    OutputLabel.Text += counter + ". " + aTag.InnerHtml + " - " + aTag.Attributes["href"].Value + "\t" + "<br />";

    Explaining the code (MyScraper.aspx.cs)

var getHtmlWeb = new HtmlWeb(); 

Get an instance of HtmlWeb() to use the Load method to get the DOM elements of a URL.

var document = getHtmlWeb.Load(InputTextBox.Text); 

Getting the DOM elements using Load method.

var aTags = document.DocumentNode.SelectNodes("//a");

After getting the DOM elements as an HtmlDocument format we use DocumentNode to select all nodes using SelectNodes of a particular tag (in our case it’s the “a” tag).

int counter = 1;

We put a counter to count the number of links we found.

if (aTags != null)
    foreach (var aTag in aTags)
       OutputLabel.Text += counter + ". " + aTag.InnerHtml + " - " + 
         aTag.Attributes["href"].Value + "\t" + "<br />";

Then we check if the nodes exist or not. It it exists the we loop through the nodes and print the InnerHtml of that node that is <a> (tag) and the “href” attributes value of that node incrementing the value each time it finds a new node.

After that press F6 to build the project and f5 to run it. Give the following input and click on Click Me. You'll see that it'll bring all the href's and innerHtml of <a> tags of that URL and the output will be as following:

Image 8

So, this is how we used HtmlAgilityPack with ASP.NET to parse DOM elements from a webpage. You can parse all the tags in different formats, traverse them as ParentNode or ChildNodes or many more ways using the built-in classes and functions. HAP gives you more flexibility on going through the DOM elements and selecting which one you want to play with. Hope you like it.


Go to and follow the forum and discussions. In the documentation tab you'll find no help when I am writing this article. So you can come up with more better contribution to this open source project. Try to go through all the features and functionality HAP provides. The more you'll know it'll be more easier for you to Scrap more easily.




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


About the Author

Md Ashaduzzaman
Software Developer Secure Link Services
Bangladesh Bangladesh
No Biography provided

Comments and Discussions

GeneralMy vote of 5 Pin
Member 1296242926-Apr-17 23:07
MemberMember 1296242926-Apr-17 23:07 
QuestionQuestion Pin
Member 1193088718-Feb-16 18:41
MemberMember 1193088718-Feb-16 18:41 
SuggestionStep 5: if you are confused, MSDN has an explanation: Pin
Tom Dane13-Jul-15 0:01
MemberTom Dane13-Jul-15 0:01 
QuestionCould not found whole HTML document Pin
sahukuldeep18-Oct-14 3:01
Membersahukuldeep18-Oct-14 3:01 
QuestionExtracting all items without clicking 'More' button Pin
SweetNeetu7-Jul-14 5:16
MemberSweetNeetu7-Jul-14 5:16 
AnswerRe: Extracting all items without clicking 'More' button Pin
Md Ashaduzzaman20-Oct-14 2:11
professionalMd Ashaduzzaman20-Oct-14 2:11 
QuestionHelp Pin
Ramizzz9-Feb-14 13:23
MemberRamizzz9-Feb-14 13:23 
AnswerRe: Help Pin
Md Ashaduzzaman10-Feb-14 4:56
professionalMd Ashaduzzaman10-Feb-14 4:56 
QuestionRemove the images containing source code Pin
Manfred Rudolf Bihy2-Jan-14 22:54
professionalManfred Rudolf Bihy2-Jan-14 22:54 
AnswerRe: Remove the images containing source code Pin
Md Ashaduzzaman3-Jan-14 22:14
professionalMd Ashaduzzaman3-Jan-14 22:14 
GeneralMy vote of 5 Pin
newton.saber2-Oct-13 2:53
Membernewton.saber2-Oct-13 2:53 
GeneralRe: My vote of 5 Pin
Md Ashaduzzaman2-Oct-13 3:00
professionalMd Ashaduzzaman2-Oct-13 3:00 

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.