BindingNavigator

Updated over 6 months ago

The BindingNavigator control in your application will be converted to RadBindingNavigator. The following tables describe which properties and methods are removed and which are replaced with similar equivalents.

Properties	Action	RadControls Equivalent
AllowItemReorder	Removed
AllowMerge	Removed
CanOverflow	Removed
GripMargin	Removed
GripStyle	Removed
RenderMode	Removed
Stretch	Removed
TextDirection	Produces Error
AddNewItem	Replaced	BindingNavigatorElement.AddNewButton
CountItem	Replaced	BindingNavigatorElement.PageLabel
DeleteItem	Replaced	BindingNavigatorElement.DeleteButton
MoveFirstItem	Replaced	BindingNavigatorElement.FirstButton
MoveLastItem	Replaced	BindingNavigatorElement.LastButton
MoveNextItem	Replaced	BindingNavigatorElement.NextButto
MovePreviousItem	Replaced	BindingNavigatorElement.PreviousButton
PositionItem	Replaced	BindingNavigatorElement.CurrentNumberTextBox

Events	Action	RadControls Equivalent
BeginDrag	Produces Error
EndDrag	Produces Error
ItemAdded	Produces Error
ItemClicked	Produces Error
ItemRemoved	Produces Error
LayoutCompleted	Produces Error
LayoutStyleChanged	Produces Error
PaintGrip	Produces Error
RefreshItems	Produces Error
RendererChanged	Produces Error

Methods	Action	RadControls Equivalent
AddStandardItems()	Produces Error
GetItemAt()	Produces Error

Standard BindingNavigator and our RadBindingNavigator have different mapping of items' name. That's why the navigation will not work after the conversion process is finished. In order to resolve the issue, you need to change the Name properties of each item manually in the Designer file. Each name should starts with BindingNavigator's name plus item's name. For example: this.bindingNavigator1.Name = "bindingNavigator1";

We strongly recommend you to change the Name properties of each item manually after opening the form at design time. In addition, if there are other items added to the navigator, they will be converted as well, their properties, events and methods are listed here.

Standard Binding Navigator	Telerik RadBindingNavigator
this.bindingNavigatorAddNewItem.Name = "bindingNavigatorAddNewItem";	this.bindingNavigatorAddNewItem.Name = "bindingNavigator1AddNewItem";
this.bindingNavigatorCountItem.Name = "bindingNavigatorCountItem";	this.bindingNavigatorCountItem.Name = "bindingNavigator1CountItem";
this.bindingNavigatorDeleteItem.Name = "bindingNavigatorDeleteItem";	this.bindingNavigatorDeleteItem.Name = "bindingNavigator1DeleteItem";
this.bindingNavigatorMoveFirstItem.Name = "bindingNavigatorMoveFirstItem";	this.bindingNavigatorDeleteItem.Name = "bindingNavigator1MoveFirstItem";
this.bindingNavigatorMoveLastItem.Name = "bindingNavigatorMoveLastItem";	this.bindingNavigatorMoveLastItem.Name = "bindingNavigator1MoveLastItem";
this.bindingNavigatorMoveNextItem.Name = "bindingNavigatorMoveNextItem";	this.bindingNavigatorMoveNextItem.Name = "bindingNavigator1MoveNextItem";
this.bindingNavigatorMovePreviousItem.Name = "bindingNavigatorMovePreviousItem";	this.bindingNavigatorMovePreviousItem.Name = "bindingNavigator1MovePreviousItem";
this.bindingNavigatorPositionItem.Name = "bindingNavigatorPositionItem";	this.bindingNavigatorPositionItem.Name = "bindingNavigator1PositionItem";