Click here to Skip to main content
Click here to Skip to main content
Go to top

AJAX DLL

, 30 Jul 2014
Rate this:
Please Sign up or sign in to vote.
.NET library to call server side method from JavaScript.

Introduction 

AJAX DLL is a library developed using .NET for ASP.NET 3.0/3.5/4.0/4.5. It is used to call server side methods from JavaScript. You can pass the method parameter value from JavaScript. A parameter can be a variable or a Model object.

In the given example, I have used the parameter as a string variable, an array object and a Model class object. A benefit of this DLL is that you can use it at UserControl level, so if you have some method in UserControl and you want to call it via JavaScript, you can achieve it using this DLL. A drawback of this DLL is that you cannot access your server control in your method, because the Page Life Cycle is not involved during the method call like in UpdatePanel. But you can access your server control from JavaScript and assign the value which will be returned by the AJAX method.

Using the Code   

It’s very simple to use Ajax DLL. You need to create a web application or a web site and add reference of Ajax.dll which is in the attached file.

Once a DLL has been added into your application, you need to place a line code in the Page_Load event as below:

Page_Load

This code will register your page class in DLL with all your AJAX method(s) written in the page class, which are given in the image below. Check the below image, you will find that the methods have been annotated with an attribute Ajax.AjaxMethod. You need to annotate with an attribute to the methods which you want to call from JavaScript.

There are five optional parameters with the Ajax.AjaxMethod attribute:

  1. Method name: A method which you want to call from JS. Default will be the same method name which you have created.
  2. Js callback method name: On Successful End Request of the AJAX call. Default will be the Callback_<your method name>.
  3. Js Error method Name: Any Error at the time of End Request of the AJAX call. Default will be the Error_<your method name>.
  4. Loading Text: The text you want to show. Default text is string.Empty.
  5. Asynchronous Call: Boolean value, used to make your call synchronous from JavaScript. Default value is True.

demoajaxapp/Methods.JPG

Once the methods have been written, you can call all these methods from JS as defined in the first parameter of Ajax.AjaxMethod. For that, you can write the JS methods as below: 

Check here the CallTest1() function. From the function, the PassArrayObject method is called as defined in the first parameter of the Ajax attribute. The parameter value and the method name should be the same. Also check the last function CallReturnEvenOdd() for which the callback method or error method is not required, because its server method ReturnEvenOdd is defined with the IsAsync=false parameter (check the previous image). So the value will be returned to the same function CallReturnEvenOdd(). _Default object is used to call the methods PassArrayObject and ReturnEvenOdd. This  _Default is nothing but the page class name.  So now we can create same name methods in page as well as in user control and call with respective class object.  

At last, you need to apply some configuration in the web.config file as below: 

The latest Ajax dll  supports Restful Service call. Note that it will call only those Restful Services which are in same domain. Steps to call Restful Service using this dll are given below. 

  1. Create Restful Service in your project.  
  2. Call using  SmartAjax.CallService method, which has 3 parameters.  
    1. URL: Restful service url  
    2. Method Parameters: Parameters in String Json format 
    3. Callback methods: 
      • onSuccess: A method name on successful call   
      • onError: A method name on error   

 

A complete example is given in attached demo project. 

 Find the HTML code here: 

<%@ Page Language="C#" AutoEventWireup="true" 
         Codebehind="Default.aspx.cs" Inherits="DemoAjaxApp._Default"%>

<%@ Register Assembly="System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"
    Namespace="System.Web.UI" TagPrefix="asp" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
        "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title>Ajax Demo</title>

    <script language="javascript" type="text/javascript">
		function CallTest()
		{
			var id=document.getElementById('txtClientId').value;
			_Default.Test(id);
		}
		function NameLength(obj)
		{
			var i=0;
			var newdiv = document.getElementById('EmpData');
			newdiv.innerHTML = "";
			if(obj == null)
			{	
		        newdiv.innerHTML = "No Employee Found";
		        return;
		    }
			mytable = document.createElement("table");
			mytable.cellSpacing = "0px";
			mytable.style.border = "1px solid #000";
			mytablebody = document.createElement("tbody");
			mycurrent_row = document.createElement("tr");
			for(i=0;i<obj.Rows[0].Columns.length;i++)
			{
					mycurrent_cell = document.createElement("td");
					currenttext = document.createTextNode(obj.Rows[0].Columns[i].Name);
					mycurrent_cell.appendChild(currenttext);
					mycurrent_cell.style.border = "1px solid #000";
					mycurrent_row.appendChild(mycurrent_cell);
			}	
			mytablebody.appendChild(mycurrent_row);	
			for(var j=0;j<obj.RowCount;j++)
			{
				var objRow = obj.Rows[j];
				mycurrent_row = document.createElement("tr");
				for(i=0;i<objRow.Columns.length;i++)
				{
					mycurrent_cell = document.createElement("td");
					if(objRow.Columns[i].Value != null)
						currenttext = document.createTextNode(objRow.Columns[i].Value + " ");
					else
						currenttext = document.createTextNode(" ");
					mycurrent_cell.appendChild(currenttext);
					mycurrent_cell.style.border = "1px solid #000";
					mycurrent_row.appendChild(mycurrent_cell);
				}
				mytablebody.appendChild(mycurrent_row);
			}
			mytable.appendChild(mytablebody);
			newdiv.appendChild(mytable);
							
		}
		function Error_Test(obj)
		{
			alert(obj.ErrMsg);
		}
		function CallTest1()
		{
		    var x = new Array();
		    x[0] = "Mehul";
		    x[1] = "Thakkar";
		    _Default.PassArrayObject(x);
		}
		function ReturnClassObject(obj)
		{
		    alert(obj.Name);
		}
		function Error_PassArrayObject(obj)
		{
			alert(obj.ErrMsg);
        }

        function CallReturnEvenOdd() {
            var id = document.getElementById('txtNumber').value;
            var msg = _Default.ReturnEvenOdd(id);
            alert(msg);
        }

		function CallTest2()
		{
		    var x = new Object();
		    x.Name = "Mehul-Thakkar";
		    x.Phone = 25460645;
		    x.Email = "mehult@xyz.com";
		    x.JoiningDate = "15-09-2010";
		    _Default.PassClassObject(x);
		}
		function ReturnLength(obj)
		{
		    alert(obj);
		}
		function Error_PassClassObject(obj)
		{
			alert(obj.ErrMsg);
        }

		function CallBack_ReturnArray(arrObj) {
        
		    var Total=0;
		    for(var i in arrObj)
		        Total+=parseInt(arrObj[i],10);
		        
		    alert(Total);
		}
		function Error_ReturnArray(arrObj) {
		    
		}
		function CallBack_ReturnStrArray(arrObj)
		{
		    var str='';
		    for(var i in arrObj)
		        str+=arrObj[i]+"\n";
		        
		    alert(str);
		}
		function CallBack_ReturnObject(clsObj)
		{
		    alert(clsObj.Email);
		}
	    function CallBack_ReturnFArray(arrObj)
		{
		    var Total=0;
		    for(var i in arrObj)
		        Total+=parseFloat(arrObj[i],10);
		        
		    alert(Total);
	    }

	    function CallBack_GenericCollection(collObj) {
	        for (var item in collObj) {
	            alert("Name: " + collObj[item].Name + "\nPhone: " + 
	              collObj[item].Phone + "\nEmail: " + collObj[item].Email);
	        }
	    }

	    function ServiceCall() {
	        SmartAjax.CallService(
            "http://localhost:2830/TestService.svc/GetData",
            '{ "value": "' + document.getElementById("txtServiceBox").value + '" }',
            { onSuccess: "serviceCallback", onError: "serviceError" }
            );
	    }

	    function serviceCallback(str) {
	        alert(str);
	    }

	    function serviceError(str) {
	        alert(str);
	    }
    </script>
</head>
<body>
    <form id="form1" runat="server">
     <asp:ScriptManager ID="ScriptManager1" runat="server">
        </asp:ScriptManager>
        <div>
            <div style="border: solid 1px yellow">
                Enter Emp No Here:
                <input type="text" id="txtClientId" />
                <a href="#" onclick="CallTest()">Retrieve Emp</a>
                <div id="EmpData">
                </div>
            </div>
            <br />
            <div style="border: solid 1px blue">
                Pass Array Object:
                <a href="#" onclick="CallTest1()">Click Here</a>
                <div id="Div1">
                </div>
            </div>
            <br />
            <div style="border: solid 1px green">
                Pass Class Object:
                <a href="#" onclick="CallTest2()">Click Here</a>
                <div id="Div2">
                </div>
            </div>
            <br />
            <div style="border: solid 1px orange">
                Return Array Object:
                <a href="#" onclick="_Default.ReturnArray()">Click Here</a>
                <div id="Div3">
                </div>
            </div>
            <br />
            <div style="border: solid 1px brown">
                Return String Array Object:
                <a href="#" onclick="_Default.ReturnStrArray()">Click Here</a>
                <div id="Div5">
                </div>
            </div>
            <br />
            <div style="border: solid 1px pink">
                Return Double Array Object:
                <a href="#" onclick="_Default.ReturnFArray()">Click Here</a>
                <div id="Div6">
                </div>
            </div>
            <br />
            <div style="border: solid 1px gray">
                Return Class Object:
                <a href="#" onclick="_Default.ReturnObject()">Click Here</a>
                <div id="Div4">
                </div>
            </div>
            <br />
            <div style="border: solid 1px silver">
                Synchronous Call using AJAX:
                <input type="text" id="txtNumber" />
                <a href="#" onclick="CallReturnEvenOdd()">Click Here</a>
                <div id="Div7">
                </div>
            </div>
            <br />
            <div style="border: solid 1px #aecfa5">
                Generic Support:
                <a href="#" onclick="_Default.GenericCollection()">Click Here</a>
                <div id="Div8">
                </div>
            </div>
            <br />
            <div style="border: solid 1px #2ec2d7">
                Restful Service Call:
                <input type="text" id="txtServiceBox" />
                <a href="#" onclick="ServiceCall()">Click Here</a>
                <div id="Div9">
                </div>
            </div>
            <br />
            <div style="border: solid 1px red">
            Access this textbox from Ajax dll
            <asp:TextBox runat="server" ID="txt"></asp:TextBox>
            <a href="#" onclick="_Default.ControlAccess()">Get Error</a>
            </div>
        </div>
       
        <asp:UpdatePanel runat="server" ID="UP1">
            <ContentTemplate>
                <asp:TextBox runat="server" ID="txt1">
                </asp:TextBox>
                <asp:Button runat="server" ID="b1" 
                       Text="click here" OnClick="b1_Click" />
            </ContentTemplate>
        </asp:UpdatePanel>
    </form>
</body>
</html>

Find the CS file code here:

using System;
using System.Data;
using System.Configuration;
using System.Collections;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;
using System.Collections.Generic;


namespace DemoAjaxApp
{

    public class Temp
    {
        string _name, _email;
        int _phone;
        DateTime _doj;

        public string Name { get { return _name; } set { _name = value; } }
        public int Phone { get { return _phone; } set { _phone = value; } }
        public string Email { get { return _email; } set { _email = value; } }
        public DateTime JoiningDate{ get {return _doj;} set{ _doj = value;}}

    }
    public partial class _Default : System.Web.UI.Page
    {
        [Ajax.AjaxMethod("Test", "NameLength", null, "Loading...")]
        public DataTable Test(string Id)
        {
            System.Data.SqlClient.SqlConnection con = 
              new System.Data.SqlClient.SqlConnection("server=mehult;Database=mehul;User Id=sa;Password=");
            System.Data.SqlClient.SqlDataAdapter Adp = 
              new System.Data.SqlClient.SqlDataAdapter("Select * from emp where no=" + Id, con);

            DataTable dt = new DataTable();
            try
            {
                Adp.Fill(dt);
                if (dt.Rows.Count > 0)
                    return dt;
                else
                    return null;
            }
            catch (Exception ex)
            {
                return null;
            }
        }
        [Ajax.AjaxMethod("PassArrayObject", 
          "ReturnClassObject", null, "Loading...")]
        public Temp PassArrayObject(string[] str)
        {
            Temp t1 = new Temp();
            foreach (string st in str)
                t1.Name += st;

            return t1;
        }

        [Ajax.AjaxMethod("PassClassObject", 
          "ReturnLength", null, "Loading...")]
        public int PassClassObject(Temp str)
        {
            return str.Name.Length;
        }

        [Ajax.AjaxMethod("ControlAccess", false, false, "Loading...")]
        public void ControlAccess(string str)
        {
            txt.Text = str;
        }

        [Ajax.AjaxMethod(false)]
        public string ReturnEvenOdd(int i)
        {
            if (i % 2 == 0)
                return "Number is Even";
            else
                return "Number is Odd";
        }

        [Ajax.AjaxMethod(null, true, false, "Loading...")]
        public int[] ReturnArray()
        {
            int[] i ={ 1, 2, 3, 4 };
            return i;
        }

        [Ajax.AjaxMethod]
        public string[] ReturnStrArray()
        {
            string[] str ={ "\\'1\\'", "2", "3", "4" };
            return str;
        }

        [Ajax.AjaxMethod(null, true, false, "Loading...")]
        public double[] ReturnFArray()
        {
            double[] i ={ 1.423, 2.543, 3.765, 4.65 };
            return i;
        }

        [Ajax.AjaxMethod(null, true, false, null)]
        public Temp ReturnObject()
        {
            Temp obj = new Temp();
            obj.Name = "hello";
            obj.Phone = 420840;
            obj.Email = "hello@helo.com";
            return obj;
        }

        [Ajax.AjaxMethod]
        public Dictionary<string, Temp> GenericCollection()
        {
            return new Dictionary<string, Temp> { {"1", 
              new Temp { Email = "test1@helo.com", Name = "test1", Phone = 1234567 }},
             {"2", new Temp { Email = "test2@helo.com", Name = "test2", Phone = 21345 }}};
        }

        protected void Page_Load(object sender, EventArgs e)
        {
            Ajax.Utility.GenerateMethodScripts(this);
        }

        protected void b1_Click(object sender, EventArgs e)
        {
            txt1.Text = "hello";
        }
    }
}

History 

  • 30th Jul 2014: Article updated. 
    1. Consecutive ajax call support. Enable to make another ajax call from success or error method of first ajax call.
  • 20th Jul 2013: Article updated. 
    1. More object oriented js.
    2. Generic support. 
    3. Restful Service support.  
  • 9th Jul, 2011: Article updated.
    1. No need to add extensions "ajax" & "ajaxj" in IIS.
    2. ShowLoading parameter is removed. If you don't want to display loading message, pass string.empty or null.
    3. New Parameter IsAsync is introduced, default value is true. If false, then it will make synchronize call from JavaScript. No Callback or Error method is required to handle it.
    4. Less JS rendering. Performance is improved.
  • 9th February, 2010: Article updated.
  • 17th November, 2009: Initial post.

License

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

Share

About the Author

Mehul M Thakkar
Technical Lead
India India
Mehul Thakkar is having 8 yrs of experience in IT industry. He is having good command over Ms .Net and Ms Sql Server

Comments and Discussions

 
QuestionNested Ajax Calls Pinmemberpyarli17-May-14 5:58 
AnswerRe: Nested Ajax Calls PinmemberMehul M Thakkar19-Jun-14 3:21 
GeneralRe: Nested Ajax Calls Pinmemberpyarli24-Jun-14 7:47 
GeneralRe: Nested Ajax Calls Pinmemberpyarli27-Jun-14 18:05 
GeneralRe: Nested Ajax Calls PinmemberMehul M Thakkar30-Jun-14 3:10 
GeneralRe: Nested Ajax Calls Pinmemberpyarli7-Jul-14 10:16 
GeneralRe: Nested Ajax Calls Pinmemberpyarli23-Jul-14 17:41 
GeneralRe: Nested Ajax Calls PinmemberMehul M Thakkar23-Jul-14 21:09 
GeneralRe: Nested Ajax Calls Pinmemberpyarli24-Jul-14 10:37 
GeneralRe: Nested Ajax Calls Pinmemberpyarli29-Jul-14 8:26 
GeneralRe: Nested Ajax Calls PinmemberMehul M Thakkar30-Jul-14 5:29 
GeneralRe: Nested Ajax Calls Pinmemberpyarli31-Jul-14 9:02 
QuestionAccesss to Session Variable Pinmemberpyarli9-Dec-13 9:39 
AnswerRe: Accesss to Session Variable PinmemberMehul M Thakkar10-Dec-13 20:46 
GeneralRe: Accesss to Session Variable Pinmemberpyarli13-Dec-13 4:28 
GeneralRe: Accesss to Session Variable PinmemberMehul M Thakkar15-Dec-13 18:42 
GeneralRe: Accesss to Session Variable Pinmemberpyarli16-Dec-13 3:44 
GeneralRe: Accesss to Session Variable PinmemberMehul M Thakkar16-Dec-13 6:04 
QuestionCould you compare this approach to one using jQuery and Ajax calls? Pinmemberahagel28-Aug-13 18:05 
AnswerRe: Could you compare this approach to one using jQuery and Ajax calls? PinmemberMehul M Thakkar17-Oct-13 23:20 
GeneralMy vote of 5 Pinmemberraj ch23-Aug-13 21:54 
GeneralMy vote of 5 PinmemberShivarajbk10-Jun-13 19:49 
QuestionWhich one is better? PinmemberShivarajbk10-Jun-13 19:43 
AnswerRe: Which one is better? PinmemberMehul M Thakkar11-Jun-13 3:26 
GeneralRe: Which one is better? PinmemberShivarajbk11-Jun-13 21:10 

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
Web03 | 2.8.140922.1 | Last Updated 30 Jul 2014
Article Copyright 2009 by Mehul M Thakkar
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid