BindingNavigator
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"; |