In general, jQuery has made Ajax very easy by providing low-level interface, shorthand methods and helper functions, which all gives us great features of handling Ajax requests in our ASP.NET Webs.
The simplest way to load data from
the server and place
the returned HTML in browser is to use
the jQuery.load() function.
The very firs time when I started playing with this function, I didn't believe it will work that much easy. What you can do with this method is simply call given url as parameter to
the load function and display
the content in
the selector after which this function is chained. So, to clear up this, let me give you one very simple example: $("#result").load("AjaxPages/Page.html");
As you can see from
the above image, after clicking
the ‘Load Content’ button which fires
the above code, we are making Ajax Get and
the Response is
the entire page HTML.
So, rather than using (old) iframes, you can now use this method to load other html pages inside
the page from where
the script with load function is called.
This method is equivalent to
the jQuery Ajax Get method
$.get(url, data, function () { })
only that
the $.load() is method rather than global function and has an implicit callback function.
To provide callback to your load, you can simply add function as second parameter, see example:
$("#result").load("AjaxPages/Page.html", function () {
alert("Page.html has been loaded successfully!")
});
Since load is part of
the chain which is follower of
the given jQuery Selector where
the content should be loaded, it means that
the $.load() function won't execute if there is no such selector found within
the DOM.
Another interesting thing to mention, and maybe you've asked yourself is how we know if GET or POST method type is executed? It's simple, if we provide 'data' as second parameter to
the load function, then POST is used, otherwise GET is assumed.
POST
$("#result").load("AjaxPages/Page.html", { "name": "hajan" }, function () {
////callback function implementation
});
GET
$("#result").load("AjaxPages/Page.html", function () {
////callback function implementation
});
Another important feature that $.load() has ($.get() does not) is loading page fragments. Using jQuery's selector capability, you can do this:
$("#result").load("AjaxPages/Page.html #resultTable");
In our Page.html,
the content now is:
So, after
the call, only
the table with id resultTable will load in our page.
As you can see, we have loaded only
the table with id resultTable (1) inside div with id result (2).
This is great feature since we won't need to filter
the returned HTML content again in our callback function on
the master page from where we have called $.load() function.
Besides
the fact that you can simply call static HTML pages, you can also use this function to load dynamic ASPX pages or ASP.NET ASHX Handlers .
Lets say we have another page (ASPX) in our AjaxPages folder with name GetProducts.aspx. This page has repeater control (or anything you want to bind dynamic server-side content) that displays set of data in it. Now, I want to filter
the data in
the repeater based on
the Query String parameter provided when calling that page. For example, if I call
the page using GetProducts.aspx?category=computers, it will load only computers… so, this will filter
the products automatically by given category.
The example ASPX code of GetProducts.aspx page is:
<%@ Page Language="C#" AutoEventWireup="true" CodeBehind="GetProducts.aspx.cs" Inherits="WebApplication1.AjaxPages.GetProducts" %>
<!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></title>
</head>
<body>
<form id="form1" runat="server">
<div>
<table id="tableProducts">
<asp:Repeater ID="rptProducts" runat="server">
<HeaderTemplate>
<tr>
<th>Product</th>
<th>Price</th>
<th>Category</th>
</tr>
</HeaderTemplate>
<ItemTemplate>
<tr>
<td>
<%# Eval("ProductName")%>
</td>
<td>
<%# Eval("Price") %>
</td>
<td>
<%# Eval("Category") %>
</td>
</tr>
</ItemTemplate>
</asp:Repeater>
</ul>
</div>
</form>
</body>
</html>
The C# code-behind sample code is:
public partial class GetProducts : System.Web.UI.Page
{
public List<Product> products;
protected override void OnInit(EventArgs e)
{
LoadSampleProductsData(); //load sample data
base.OnInit(e);
}
protected void Page_Load(object sender, EventArgs e)
{
if (Request.QueryString.Count > 0)
{
if (!string.IsNullOrEmpty(Request.QueryString["category"]))
{
string category = Request.QueryString["category"]; //get query string into string variable
//filter products sample data by category using LINQ
//and add
the collection as data source to
the repeater
rptProducts.DataSource = products.Where(x => x.Category == category);
rptProducts.DataBind(); //bind repeater
}
}
}
//load sample data method
public void LoadSampleProductsData()
{
products = new List<Product>();
products.Add(new Product() { Category = "computers", Price = 200, ProductName = "Dell PC" });
products.Add(new Product() { Category = "shoes", Price = 90, ProductName = "Nike" });
products.Add(new Product() { Category = "shoes", Price = 66, ProductName = "Adidas" });
products.Add(new Product() { Category = "computers", Price = 210, ProductName = "HP PC" });
products.Add(new Product() { Category = "shoes", Price = 85, ProductName = "Puma" });
}
}
//sample Product class
public class Product
{
public string ProductName { get; set; }
public decimal Price { get; set; }
public string Category { get; set; }
}
Mainly, I just have sample data loading function, Product class and depending of
the query string, I am filtering
the products list using LINQ Where statement. If we run this page without query string, it will show no data.
If we call
the page with category query string, it will filter automatically.
Example:
/AjaxPages/GetProducts.aspx?category=shoes
The result will be:
or if we use category=computers, like this /AjaxPages/GetProducts.aspx?category=computers,
the result will be:
So, now using jQuery.load() function, we can call this page with provided query string parameter and load appropriate content…
The ASPX code in our Default.aspx page, which will call
the AjaxPages/GetProducts.aspx page using jQuery.load() function is:
<asp:RadioButtonList ID="rblProductCategory" runat="server">
<asp:ListItem Text="Shoes" Value="shoes" Selected="True" />
<asp:ListItem Text="Computers" Value="computers" />
</asp:RadioButtonList>
<asp:Button ID="btnLoadProducts" runat="server" Text="Load Products" />
<!-- Here we will load
the products, based on
the radio button selection-->
<div id="products"></div>
</form>
The jQuery code:
$("#<%= btnLoadProducts.ClientID %>").click(function (event) {
event.preventDefault(); //preventing button's default behavior
var selectedRadioButton = $("#<%= rblProductCategory.ClientID %> input:checked").val();
//call GetProducts.aspx with
the category query string for
the selected category in radio button list
//filter and get only
the #tableProducts content inside #products div
$("#products").load("AjaxPages/GetProducts.aspx?category=" + selectedRadioButton + " #tableProducts");
});
The end result:
You can download
the code sample from here.
You can read more about jQuery.load() function here.
I hope this was useful blog post for you.
Please do let me know your feedback.
Best Regards,
Hajan
