C# – Reset scroll position after Async postback – ASP.NET

asp.netasp.net-ajaxcgridviewscroll-position

What is the best way to reset the scroll position to the top of page after the an asynchronous postback?

The asynchronous postback is initiated from a ASP.NET GridView CommandField column and the ASP.NET update panel Update method is called in the GridView OnRowCommand.

My current application is an ASP.NET 3.5 web site.

EDIT: I have received excellent feedback from everyone, and I ended using the PageRequestManager method in a script tag, but my next question is:

How do I configure it to only execute when the user clicks the ASP.NET CommandField in my GridView control? I have other buttons on the page that perform an asynchronous postback that I do not want to scroll to the top of the page.

EDIT 1: I have developed a solution where I do not need to use the PageRequestManager. See my follow up answer for solution.

Best Answer

As you're using UpdatePanels you're going to need to hook into the ASP.NET AJAX PageRequestManager

You'll need to add a method to the endRequest event hooks that are:

Raised after an asynchronous postback is finished and control has been returned to the browser.

So you'd have something like:

<script type="text/javascript">
  Sys.WebForms.PageRequestManager.getInstance().add_endRequest(pageLoaded);

  function pageLoaded(sender, args) {
     window.scrollTo(0,0);
  }
</script>

Which will force the browser to scroll back to the top of the page once an update request has completed.

There are other events you could hook into instead of course:

beginRequest // Raised before the request is sent
initializeRequest // Raised as the request is initialised (good for cancelling)
pageLoaded // Raised once the request has returned, and content is loaded
pageLoading // Raised once the request has returned, and before content is loaded

The beauty of asynchronous post-backs is that the page will maintain the scroll height without you having to set MaintainScrollPosition, as there is no "full page reload" happening, in this case you actually want that effect to happen, so you will need to manually create it.

Edit to respond to updated question

Ok, so if you need to only reset the postion on certain button presses you'll need to do something like this:

Start by hooking into the BeginRequest instead/as well:

Sys.WebForms.PageRequestManager.getInstance().add_beginRequest(BeginRequestHandler);

This is because in the args parameter you get access to:

args.get_postBackElement().id

Which will tell you the id of the button that started the whole event - you can then either check the value here, and move the page, or store it in a variable, and query it in the end request - being aware of race conditions, etc where the user clicks another button before your original update completes.

That should get you going with any luck - there's quite a few examples around this on Working with PageRequestManager Events