PageMethods In ASP.NET AJAX
Published: 09 Mar 2010
Unedited - Community Contributed
Page Methods is a new mechanism in ASP.NET applications where the server code can be bound to ASP.NET pages. It is an easy way to communicate asynchronously with the server using ASP.NET AJAX technologies. It is an alternate to calling the page which is reliable and carries a low risk. It is basically used to expose the web methods to the client script.
by Suresh Kumar Goudampally
Average Rating: This article has not yet been rated.
Views (Total / Last 10 Days): 130763/ 117


Page Methods is a new mechanism in ASP.Net application where the server code cab be bound to Asp.Net pages.  It is an easy way to communicate asynchronously with the server using Asp.Net Ajax technologies. It’s an alternate way to call the page which is reliable and low risk.  In a nutshell, it is used to expose the web methods to the client script. 

Sample Application Demonstrating Page Methods

To enable Page methods we need to drag a ScriptManager control to the page and mark  

the EnablePageMethods to “True”.

<asp:ScriptManager ID="ScriptManager1" runat="server"   

Go the Code behind file of the page and add a static method and mark them as WebMethod. Lets Say the method name is GetPageMethod which returns a status value

public static string GetPageMethod()
      return "Welcome PageMethods";

Now that the method is exposed add a button control and call a client script which accesses the Webmethods of the page

<asp:Button ID="Button1" runat="server" Text="Call Page Methods"  
      OnClientClick="return fun()"/>

In javascript function we can use PageMethods object to call the WebMethod of the page.

function fun()
      PageMethods.GetStatus(onSucceed, onError);
      return false;
function onSucceed(result)
function onError(result)

Now run the application and check the result which shows the alert box with value “Active”. The sample application calls the webmethods of the page using client script without full page cycle.

Let’s say if the page method has two input parameters we can pass paramters as given in the below sample:

      PageMethods.GetStatus(“p1”,”p1”,onSucceed, onError);

We can also access the Session , Application and Cache variables data using the Page Methods. For example:

  protected void Page_Load(object sender, EventArgs e)
      HttpContext.Current.Session["key"] = "SomeValue";
      HttpContext.Current.Application["key1"] = "SomeValue1";

Accessing the session data in the page methods:

public static string GetStatus(string s1, string s2)
      return (string)HttpContext.Current.Session["key"];         

We can also return the application and cache data in the similar way.

return (string)HttpContext.Current.Application["key1"];         
return (string)HttpContext.Current.Cache["key"];         

Script Manager and Page Methods

The ScriptManager renders the java script to access the web methods when the EnabledPageMethods is set to “True”.  An JavaScript object Page Methods is created using which we can access the web methods of the page.    

In order to call web methods using PageMethods object we should add a function for Successful Page method call and a function for UnSuccessful Page method call as seen in our sample above. These functions can be treated as Callback functions.


We can also pass parameters to the page method along with references to call backs  separated by “,”.

We can pass n number of parameters to the page methods from the client script which are required for processing and getting the result.


The syntax for calling the page methods using PageMethods object and passing parameters:


Internally the script manager builds the PageUrl and XmlHttpRequest and then post the request to the server to fetch the required result. Ultimately its all the XmlHttpRequest stuff that is wrapped up for easy usage.

CallBack Methods and Their Significance

We can pass parameters to Page methods and then the call back methods. We can pass the references to the four call back methods to call when the page method returns. The four call back methods are

·         onSucceed

·         onError

As we discussed we need to have callback function for success page method call and for unsuccessful page method call. Unsuccessful page method call means if there is an   internal server error on the page.

Using the call back method we can fetch the required result from the page and use it on the client script as required.

//CallBack method when the page call succeeds
function onSucceed(results, currentContext, methodName)
//CallBack method when the page call fails due to interna, server error
function onError(results, currentContext, methodName)

The method names and parameter names are user defined.  We can use any name for the callback methods and their parameters.

The OnSucceed parameter indicates the javascript function to be called when the call has succeeded and the result parameter has the result stored in it in our case the string returned from the code behind file.
The OnError parameter indicates the javascript function to be called when error occurs. The success call back method has three parameters:

·         Result – Returns the output of the page method.

·         currentContext – This is used to handle different logic when single callback is used for multiple page method requests. We can also pass array of values as userContext parameter.

·         methodName – This parameter returns the name of  page method called.

 The error call back method has three parameters:

·         Result – Returns the output of the page method.

·         currentContext – This is used to handle different logic when single callback is used for multiple page method requests. We can also pass array of values as userContext parameter.

·         methodName – This parameter returns the name of  page method called.

The result here return the type of the error, stacktrace, message and type of the exceptions. You can display the required information to the end user using the following   methods of error object

function onError(result)

Sending the userContext parameter

var contextArray = "u1";     
PageMethods.GetStatus("p1","p2",onSucceed, onError,contextArray);  

And this can be used on the call back to execute different logic

function onSucceed(result,userContext,methodname)
      if (userContext = “u1”)


·         This approach is easier and the code is shorter and reliable.

·         It provides greater compatibility since it is easy to change fast.

·         Less work for developer to write client script and a server method.

·         Page parameters become strongly typed and automatically validated.

·         You don't have to parse and convert parameters by yourself. In ASP.NET, parameters passed on URLs are available through Request.QueryString, only as strings.

·         No need to look at a target page's code to know how to call it. No need for separate documentation about ways to call a page.

·         Page parameters are automatically validated and become strongly typed.

·         As we don’t to post entire viewstate of the page using Page Methods we achieve the bandwidth benefits.

Key Points to Remember

·         The Page Method should be static using the attribute [WebMethod].

·         The Page Method can be in the code behind file of the page and in aspx file as well.

·         The EnablePageMethods property of the script manger should be marked as “True”.

·         The call back methods are mandatory to receive the processed result on the client side.

·         Page Methods don’t support all the datatypes to return to client.

·         We can access the Session. Application and Cache variables using Page Methods.



User Comments

Title: zhe   
Name: li
Date: 2012-12-18 8:10:18 PM
test how
Title: akakakak   
Name: pusing
Date: 2012-12-05 11:40:34 PM
Title: wqeqw   
Name: dasdas
Date: 2012-12-05 2:59:03 AM
Title: aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaassssssssssssssssssssssssssssssssssddddddddddddddddddddddddddddddddddddddddddxxxxxxxxxxxxxxxxxxxxxxx   
Name: wwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwdddddddddddddddddddddddddddddddaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
Date: 2012-11-28 4:18:36 AM
asdddddddddddddddddddddddddcas testing#1
Title: thx   
Name: thx
Date: 2012-11-28 4:16:33 AM
Title: aaa   
Name: sss
Date: 2012-11-19 7:25:12 AM
Title: سيش   
Name: سشي
Date: 2012-10-23 8:31:23 AM
Title: Mr.   
Name: Farooque
Date: 2012-10-19 10:05:08 AM
Title: u   
Name: hgj
Date: 2012-10-17 7:36:06 AM
Title: ddd   
Name: dd
Date: 2012-10-16 6:29:48 AM
Title: hefrhfb   
Name: dfnejdfklndg
Date: 2012-09-04 2:59:42 AM
Title: zz   
Name: zz
Date: 2012-08-30 9:53:06 AM
Title: tttyu   
Name: fdfdghf
Date: 2012-08-11 8:41:57 AM
Title: dgfdsg   
Name: dsgdsg
Date: 2012-07-26 2:00:31 AM
Title: rty   
Name: rty
Date: 2012-07-19 7:36:48 PM
Title: wwt   
Name: kevin
Date: 2012-06-09 12:21:15 AM
Title: ds   
Name: ds
Date: 2012-06-06 3:15:53 PM
Title: bmbnnnnmbnm   
Name: nbmbnm
Date: 2012-05-18 6:07:18 AM
Title: Excellent   
Name: Srinivasa Rao D
Date: 2011-12-23 1:05:20 AM
U save my day..!
Title: Invalid Method Name   
Name: Prakash
Date: 2011-07-08 4:53:41 AM
Please change method name as GetPageMethod instead of GetStatus(). Those who are copying this code, that code wont run. check befor every one run. Thanks.
Title: Good One   
Name: sachin
Date: 2011-02-01 7:43:14 AM
Understandable for those who are beginner for PageMethods....
Title: Nice Article   
Name: HPR
Date: 2011-01-24 8:41:55 PM
Nice informative article.
Title: aa   
Name: aaa
Date: 2011-01-18 5:34:27 AM
very nice
Title: why does not work in firefox and safai while javascript is enable?   
Name: AKM
Date: 2010-11-26 7:02:35 AM
Work in IE but,why does not work in firefox and safari while javascript is enable on both browser?
Title: Feedback   
Name: Atul Tiwari
Date: 2010-11-22 5:37:58 AM
Too good....
Title: A question..   
Name: Dario
Date: 2010-11-14 9:16:49 AM
Is it possible for the page method to return a structure instead a simple string?
And how to read it on client side?
Thank you!
Title: Not clear yet   
Name: M
Date: 2010-08-10 6:27:42 AM
The article could be better structured. It's all a bit chaotic and confusing...
Title: clear now   
Name: Babak Sekandari
Date: 2010-04-29 9:58:30 AM
OK, I understand now.
public static string GetStatus(string s1, string s2){ . . . appears later.
It's better to view the whole article at once.
Very good explanations by the way. Thank you very much.
Title: confused   
Name: Babak Sekandari
Date: 2010-04-28 6:59:47 PM
The page method call is: PageMethods.GetStatus(onSucceed, onError);
But the code behind sample is public static string GetPageMethod()

As Woho stated, I don't understand why one is GetPageMethod() and the other is GetStatus()
Title: setting control value   
Name: suresh kumar
Date: 2010-03-26 12:08:31 AM
that would be a logical error, have you tried to debug onsucceed method and check the value before it is assigned to textbox. Can you send me the code?
Title: setting control value   
Name: Maulik
Date: 2010-03-25 9:14:31 PM

OnSucceed event, I want to set the result value to a textbox. For that, I find the textbox and assign result to textbox's "value" property. I receive the expected value for result but textbox has an empty value..any reason?? I use onblur event of another textbox and do the same thing and at that time textbox shows result value..any idea??
Title: Good   
Name: NNN
Date: 2010-03-22 3:19:51 AM
Very good article.
Title: GetStatus   
Name: Suresh Kumar
Date: 2010-03-10 4:07:24 AM
i am referring to sample method GetStatus in the article.
Title: Interesting, but a bit confusing   
Name: Woho
Date: 2010-03-10 2:33:07 AM
You keep referring to the method GetStatus, but I guess you really mean GetPageMethod? Otherwise it doesn't make any sense...
Interesting article although, but feels a bit like "ugly coding" (the concept, not your code :) ).
Title: Good one   
Name: Bijith K B
Date: 2010-03-09 2:04:48 PM
Nice article.

Community Advice: ASP | SQL | XML | Regular Expressions | Windows

©Copyright 1998-2021  |  Page Processed at 2021-11-29 9:00:31 AM  AspAlliance Recent Articles RSS Feed
About ASPAlliance | Newsgroups | Advertise | Authors | Email Lists | Feedback | Link To Us | Privacy | Search