New to Telerik UI for ASP.NET AJAX? Download free 30-day trial

Migrating From RadToolBar ASP.NET to ASP.NET AJAX

To migrate a Web application from RadToolBar "Classic" to RadToolBar for ASP.NET AJAX you need to follow these steps:

  1. Make sure you have installed ASP.NET AJAX. Info can be found at

  2. If your web application is not using ASP.NET AJAX you need to configure it to do so. Detailed instructions can be found at (Look for the topic called "Adding ASP.NET AJAX Configuration Elements to an Existing Web Site".)

  3. Add a ScriptManager control to the page (or user control) in which you want to add any RadControls for ASP.NET AJAX. If your page is a content page you can add the ScriptManager control in your master page. For further details about the ScriptManager control, see

  4. Drag and drop a control from the RadControls for ASP.NET AJAX package or manually copy the Telerik.Web.UI.dll in the Bin folder.

  5. Replace the classic RadToolBar directive<%@ Register TagPrefix="rad" Namespace="Telerik.WebControls" Assembly="RadToolbar.NET2" %>with the new one of RadToolBar for ASP.NET AJAX:<%@ Register Assembly="Telerik.Web.UI" Namespace="Telerik.Web.UI" TagPrefix="telerik" %>

Differences between RadToolBar "classic" and RadToolBar for ASP.NET AJAX

RadToolbar for ASP.NET AJAX contains a number of changes because of moving from the ASP.NET to the Ajax framework of the Telerik.Web.UI suite. These changes are listed below:

New button types

The types of buttons you can add to the toolbar has been expanded. Instead of a single type of control that the toolbar can contain (RadToolBarButton), you can now choose from three button types:

  • RadToolBarButton

  • RadToolBarDropDown

  • RadToolBarSplitButton

Server-side API changes

In the server-side API, some properties have been removed and a few have changed their names. Some of the events have changed as well. These changes are described below:


The following table lists the changes to the RadToolBar class:


RadToolBar "Classic" RadToolBar for ASP.NET AJAX
ContentFile use LoadContentFile () instead.
DisplayEnds -
ImagesDir use ImageUrl for each item
LoadXmlString LoadXml
Orientation Orientation
PostBackUrl PostBackUrl and item.PostBackUrl
ShortCutKey item.AccessKey
RadControlsDir -
SkinsDir -
SkinsPath -
UseFadeEffect -
AutoPostBack obsolete
UseFadeEffect -
OnClick ButtonClick
ItemAdded ItemCreated and ItemDataBound


The following table lists the changes to the RadToolBarButton class:


RadToolBar "Classic" RadToolBar for ASP.NET AJAX
BubbleCommandArgument -
BubbleCommandName -
ButtonImage ImageUrl
ButtonText Text
DisplayType -
Hidden -
ParentToolbar ToolBar

The RadToolbarButton class for ASP.NET now has the PostBack property which can be set in code-behind to specify which buttons will postback and which will not.

Client-side API changes

The client-side API has been heavily revised to accommodate new features. In addition, all for ASP.NET AJAX controls follow the MS AJAX naming convention. In order to migrate from RadToolbar "Classic", the method calls and property accessors should use the new convention. A reference table is included below.

RadToolbar class

The following table lists the changes to the RadToolBar client-side object:


RadToolBar "Classic" RadToolBar for ASP.NET AJAX
MakeHorizontal() set_orientation(Telerik.Web.UI.RadToolBarOrientation.Horizontal)
MakeVertical() set_orientation(Telerik.Web.UI.RadToolBarOrientation.Vertical)
EnableButton() item.set_enabled(true) or item.enable()
DisableButton() button.set_enabled(false) orbutton.disable()
HideButton() item.set_visible(false) oritem.hide()
ShowButton() item.set_visible(true)
AttachEvent() obsolete
ToggleONButton() item.set_checked(true) oritem.toggle()
ToggleOFFButton() item.set_checked(false) oritem.unCheck()
AutoPostBack obsolete
Orientation get_orientation()
UseFadeEffect -
OnClientMouseOver OnClientMouseOver
OnClientMouseOut OnClientMouseOut
OnClientClick OnClientButtonClicking OnClientButtonClicked
OnClientMouseDown OnClientMouseDown
OnClientButtonToggled OnClientCheckedStateChanging OnClientCheckedStateChanged
OnClientOrientationChanged -

RadToolBarButton class

The following table lists the changes to the RadToolBarButton client-side object:


RadToolbar "Classic" RadToolBar for ASP.NET AJAX
CommandName get_commandName()
Enabled get_enabled()
Hidden get_visible()
IsToggle get_checked()
ToolbarInstance get_toolBar()

The RadToolbarToggleButton has been removed. Now you can achieve this functionality by setting the CheckOnCLick="true" for the toolbar button.

See Also

In this article
Not finding the help you need? Improve this article