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

Ajax Tutorial for Beginners: Part 1

Rate me:
Please Sign up or sign in to vote.
4.67/5 (71 votes)
2 Dec 2008CPOL5 min read 332.6K   4.3K   156   52
Ajax Tutorial for Beginners: Part 1
AJAX1.jpg

Introduction

Hello everyone. This is my first article on The Code Project. I hope you will get some benefit from it. I have been learning Ajax for the last 5 months and now I want to share my knowledge with you. Please provide feedback on any mistakes which I have made in this article. Believe me guys, your harsh words would be received with love and treated with the top most priority.

I have explained Ajax with XML and JSON in part 2, which you can read here

There are many books and articles out there explaining the 5 Ws (Who, What, Where, When, Why) of Ajax, but I will explain to you in my own simple way. So what is Ajax? The term AJAX (Asynchronous JavaScript and XML) has been around for three years created by Jesse James Garrett in 2005. The technologies that make Ajax work, however, have been around for almost a decade. Ajax makes it possible to update a page without a refresh. Using Ajax, we can refresh a particular DOM object without refreshing the full page.

Background of Ajax

In Jesse Garrett’s original article that coined the term, it was AJAX. The “X” in AJAX really stands for XMLHttpRequest though, and not XML. Jesse later conceded that Ajax should be a word and not an acronym and updated his article to reflect his change in heart. So “Ajax” is the correct casing. As its name implies, Ajax relies primarily on two technologies to work: JavaScript and the XMLHttpRequest. Standardization of the browser DOM (Document Object Model) and DHTML also play an important part in Ajax’s success, but for the purposes of our discussion we won't examine these technologies in depth.

How Ajax Works

At the heart of Ajax is the ability to communicate with a Web server asynchronously without taking away the user’s ability to interact with the page. The XMLHttpRequest is what makes this possible. Ajax makes it possible to update a page without a refresh. By Ajax, we can refresh a particular DOM object without refreshing the full page. Let's see now what actually happens when a user submits a request:

AJAX2.JPG

  1. Web browser requests for the content of just the part of the page that it needs.
  2. Web server analyzes the received request and builds up an XML message which is then sent back to the Web browser.
  3. After the Web browser receives the XML message, it parses the message in order to update the content of that part of the page.

AJAX uses JavaScript language through HTTP protocol to send/receive XML messages asynchronously to/from Web server. Asynchronously means that data is not sent in a sequence.

Common Steps that AJAX Application Follows

The figure below describes the structure of HTML pages and a sequence of actions in Ajax Web application:

How Ajax Works

  1. The JavaScript function handEvent() will be invoked when an event occurred on the HTML element.
  2. In the handEvent() method, an instance of XMLHttpRequest object is created.
  3. The XMLHttpRequest object organizes an XML message within about the status of the HTML page, and then sends it to the Web server.
  4. After sending the request, the XMLHttpRequest object listens to the message from the Web server.
  5. The XMLHttpRequest object parses the message returned from the Web server and updates it into the DOM object.

Let's See How Ajax Works in the Code

Let’s start to put these ideas together in some code examples.

ASP.NET
form id="form1" runat="server"

div
input type="text" id="lblTime"

br
input type="button" id="btnGetTime" value="Get Time" onclick="GetTime();"

div
form
  1. From the above code, our DOM object is (input type="text" id="lblTime") which we have to refresh without refreshing the whole page. This will be done when we press the event of a button, i.e. onclick.
  2. In this code, our handEvent() is GetTime() from the above Figure-2 if you take a look at it.

Let's see now how we create an XmlHttpRequest object and make Ajax work for us.

The basic implementation of the XMLHttpRequest in JavaScript looks like this:

JavaScript
var xmlHttpRequest;

function GetTime()
{
    //create XMLHttpRequest object
    xmlHttpRequest = (window.XMLHttpRequest) ? 
	new XMLHttpRequest() : new ActiveXObject("Msxml2.XMLHTTP");

    //If the browser doesn't support Ajax, exit now
    if (xmlHttpRequest == null)
	return;

    //Initiate the XMLHttpRequest object
    xmlHttpRequest.open("GET", "Time.aspx", true);

    //Setup the callback function
    xmlHttpRequest.onreadystatechange = StateChange;

    //Send the Ajax request to the server with the GET data
    xmlHttpRequest.send(null);
}
function StateChange()
{
    if(xmlHttpRequest.readyState == 4)
    {
	document.getElementById('lblTime').value = xmlHttpRequest.responseText;
    }
}
  1. Now from the above Figure-2 handEvent() i.e. GetTime() creates an XMLHttpRequest object inside it like this:

    ASP.NET
    //create XMLHttpRequest object
    xmlHttpRequest = (window.XMLHttpRequest) ? 
    	new XMLHttpRequest() : new ActiveXObject("Msxml2.XMLHTTP");
  2. If the browser does not support Ajax, it will return false.

  3. Next we open our connection to the server with our newly created XMLHttpRequest object. Here the Time.aspx page is the page from which we will get XML message that is stored on the Web server.

    ASP.NET
    //Initiate the XMLHttpRequest object
    xmlHttpRequest.open("GET", "Time.aspx", true);
  4. You often hear the term “callback” replace the term “postback” when you work with Ajax. That’s because Ajax uses a “callback” function to catch the server’s response when it is done processing your Ajax request. We establish a reference to that callback function like this. Here StateChange is a function where we update or set a new value to our DOM object, i.e "lblTime".

    ASP.NET
    //Setup the callback function
    xmlHttpRequest.onreadystatechange = StateChange;

    Let's have a look at our callback function:

    JavaScript
    function StateChange()
    {
        if(xmlHttpRequest.readyState == 4)
        {
    	document.getElementById('lblTime').value = xmlHttpRequest.responseText;
        }
    }

    onreadystatechange will fire multiple times during an Ajax request, so we must evaluate the XMLHttpRequest’s “readyState” property to determine when the server response is complete which is 4. Now if readyState is 4, we can update the DOM object with the response message we get from the Web server.

  5. As the request method we are sending is "GET" (remember it is case sensitive), there is no need to send any extra information to the server.

    ASP.NET
    //Send the Ajax request to the server with the GET data
    xmlHttpRequest.send(null);

    In Time.aspx.cs on Page_Load event, write a simple response like this which is our response message:

    C#
    Response.Write( DateTime.Now.Hour + ":" + DateTime.Now.Minute + 
    					":" + DateTime.Now.Second );

    That’s it. That’s Ajax. Really.

Key Points to be Remembered in Ajax

There are three key points in creating an Ajax application, which are also applicable to the above Tutorial:

  1. Use XMLHttpRequest object to send XML message to the Web server
  2. Create a service that runs on Web server to respond to request
  3. Parse XMLHttpRequest object, then update to DOM object of the HTML page on client-side

History

  • 20th November, 2008: Initial version

License

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



Comments and Discussions

 
GeneralMy vote of 1 Pin
mrjazzz9-Jan-18 10:46
mrjazzz9-Jan-18 10:46 
QuestionNot for beginners for sure Pin
mrjazzz9-Jan-18 10:43
mrjazzz9-Jan-18 10:43 
Questionerror: AJAX request failed Pin
Member 1187094128-Jul-15 22:56
Member 1187094128-Jul-15 22:56 
QuestionAJAX Pin
Member 1187094128-Jul-15 22:45
Member 1187094128-Jul-15 22:45 
QuestionThanks Pin
Member 1092935120-Apr-15 3:15
Member 1092935120-Apr-15 3:15 
QuestionGood Pin
sangeetha m20-May-14 1:00
sangeetha m20-May-14 1:00 
hi ,
i have followed your steps that how to use the ajax to get the json file instead of xml. am trying out this from my laptop for myself.

in this line, xmlHttpRequest.open("GET", "Data.json", true);
i have used "Data.josn" file which is my local json file.but when i click the button i could not get the json data in textbox.

can u please help me from this?
GeneralMy vote of 5 Pin
Pratik Bhuva13-Sep-13 4:27
professionalPratik Bhuva13-Sep-13 4:27 
GeneralMy vote of 5 Pin
santhudotnet12-Aug-13 20:36
santhudotnet12-Aug-13 20:36 
GeneralMy vote of 4 Pin
Alireza_136211-Jul-13 15:18
Alireza_136211-Jul-13 15:18 
GeneralMy vote of 5 Pin
Jeyo19908-Jul-13 17:57
Jeyo19908-Jul-13 17:57 
QuestionAjax Pin
shujaat siddique3-Jun-13 20:24
shujaat siddique3-Jun-13 20:24 
QuestionValuble information Pin
Purushotham Agaraharam27-Mar-13 21:05
Purushotham Agaraharam27-Mar-13 21:05 
GeneralMy vote of 5 Pin
Girish Balanagu15-Feb-13 1:10
Girish Balanagu15-Feb-13 1:10 
QuestionGood One Pin
Member 97442313-Feb-13 20:31
Member 97442313-Feb-13 20:31 
GeneralMy vote of 5 Pin
Pranit Kothari23-Nov-12 21:45
Pranit Kothari23-Nov-12 21:45 
GeneralMy vote of 5 Pin
iliabest11-Nov-12 2:21
iliabest11-Nov-12 2:21 
GeneralMy vote of 4 Pin
Doppalapudi16-Oct-12 22:38
Doppalapudi16-Oct-12 22:38 
GeneralMy vote of 5 Pin
yogesh_iitrk20-May-12 23:06
yogesh_iitrk20-May-12 23:06 
GeneralMy vote of 5 Pin
Sam Path14-Feb-12 18:41
Sam Path14-Feb-12 18:41 
QuestionError in text box value is ===full page descripation Pin
sunilefusion6-Feb-12 22:00
sunilefusion6-Feb-12 22:00 
GeneralMy vote of 3 Pin
vyashitesh24-Jan-12 2:53
vyashitesh24-Jan-12 2:53 
GeneralMy vote of 4 Pin
rameshrathod8-Sep-11 18:16
rameshrathod8-Sep-11 18:16 
GeneralMy vote of 5 Pin
Md. Touhidul Alam Shuvo26-Jun-11 20:44
Md. Touhidul Alam Shuvo26-Jun-11 20:44 
GeneralRe: My vote of 5 Pin
bymgdotnet27-Jun-11 21:20
bymgdotnet27-Jun-11 21:20 
GeneralIE and caching Pin
Andrew de Jonge16-May-11 3:48
Andrew de Jonge16-May-11 3:48 

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.