# BindingNavigator Namespace: **Wisej.Web** Assembly: **Wisej.Framework** (4.0.0.0) * [Control](https://docs.wisej.com/api/wisej.web/general/control) * [ScrollableControl](https://docs.wisej.com/api/wisej.web/containers/scrollablecontrol) * [Panel](https://docs.wisej.com/api/wisej.web/containers/wisej.web.panel) * [FlowLayoutPanel](https://docs.wisej.com/api/wisej.web/containers/flowlayoutpanel) * [BindingNavigator](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.bindingnavigator) Represents the navigation and manipulation user interface (UI) for controls that are bound to a data source. {% tabs %} {% tab title="C#" %} ```csharp public class BindingNavigator : FlowLayoutPanel, ISupportInitialize ``` {% endtab %} {% tab title="VB.NET" %} ```visual-basic Public Class BindingNavigator Inherits FlowLayoutPanel Implements ISupportInitialize ``` {% endtab %} {% endtabs %} ## Constructors ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) BindingNavigator(bindingSource) Initializes a new instance of the [BindingNavigator](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.bindingnavigator) class with the specified [BindingSource](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.bindingsource) as the data source. | Name | Type | Description | | ----------------- | ------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------- | | **bindingSource** | [BindingSource](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.bindingsource) | The [BindingSource](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.bindingsource) used as a data source. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) BindingNavigator(addStandardItems) Initializes a new instance of the [BindingNavigator](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.bindingnavigator) class, indicating whether to display the standard navigation user interface (UI). | Name | Type | Description | | -------------------- | --------------------------------------------------------------- | ------------------------------------------------------------ | | **addStandardItems** | [Boolean](https://docs.microsoft.com/dotnet/api/system.boolean) | true to show the standard navigational UI; otherwise, false. | ## Properties ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) AddNewItem [Button](https://docs.wisej.com/api/wisej.web/buttons/button): Returns or sets the "Add New" button. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) BindingSource [BindingSource](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.bindingsource): Returns or sets the [BindingSource](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.bindingsource) component that is the source of data. (Default: `null`) ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) CountItem [Label](https://docs.wisej.com/api/wisej.web/content/wisej.web.label): Returns or sets the control that displays the total number of items in the associated [BindingSource](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.bindingsource). ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) CountItemFormat [String](https://docs.microsoft.com/dotnet/api/system.string): Gets or sets a string used to format the information displayed in the [CountItem](#countitem) control. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) DeleteItem [Button](https://docs.wisej.com/api/wisej.web/buttons/button): Returns or sets the "Delete" button. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) MoveFirstItem [Button](https://docs.wisej.com/api/wisej.web/buttons/button): Returns or sets the "Move First" button. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) MoveLastItem [Button](https://docs.wisej.com/api/wisej.web/buttons/button): Returns or sets the "Move Last" button. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) MoveNextItem [Button](https://docs.wisej.com/api/wisej.web/buttons/button): Returns or sets the "Move Next" button. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) MovePreviousItem [Button](https://docs.wisej.com/api/wisej.web/buttons/button): Returns or sets the "Move Previous" button. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) Orientation [Orientation](https://docs.wisej.com/api/wisej.web/enumerations/wisej.web.orientation): Returns or sets a value indicating the horizontal or vertical orientation of the [BindingNavigator](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.bindingnavigator) control. When the control is docked, this property is managed automatically. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) PositionItem [TextBox](https://docs.wisej.com/api/wisej.web/editors/wisej.web.textbox): Returns or sets the TextBox control that displays the current position within the associated [BindingSource](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.bindingsource). ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) Text [String](https://docs.microsoft.com/dotnet/api/system.string): Returns or sets the text to display on the tab. (Default: `""`) ## Methods ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) AddStandardItems() Adds the standard set of navigation items to the [BindingNavigator](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.bindingnavigator) control. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) BeginInit() Disables updates to the controls of during the component's initialization. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-9bf7fa01e02f4da0f9ef90d3b049ae43e664919e%2Fprotected.png?alt=media) Dispose(disposing) Clean up any resources being used. | Parameter | Type | Description | | ------------- | --------------------------------------------------------------- | --------------------------------------------------------------- | | **disposing** | [Boolean](https://docs.microsoft.com/dotnet/api/system.boolean) | true if managed resources should be disposed; otherwise, false. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) EndInit() Enables updates to the controls after the component's initialization has completed. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-9bf7fa01e02f4da0f9ef90d3b049ae43e664919e%2Fprotected.png?alt=media) OnDockChanged(e) Fires the [DockChanged](https://docs.wisej.com/api/general/control#dockchanged) event. | Parameter | Type | Description | | --------- | ------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | | **e** | [EventArgs](https://docs.microsoft.com/dotnet/api/system.eventargs) | An [EventArgs](https://docs.microsoft.com/dotnet/api/system.eventargs) that contains the event data. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-9bf7fa01e02f4da0f9ef90d3b049ae43e664919e%2Fprotected.png?alt=media) OnRefreshItems(e) Fires the [RefreshItems](#refreshitems) event. | Parameter | Type | Description | | --------- | ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | **e** | [EventArgs](https://docs.microsoft.com/dotnet/api/system.eventargs) | A [EventArgs](https://docs.microsoft.com/dotnet/api/system.eventargs) that contains the event data. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-9bf7fa01e02f4da0f9ef90d3b049ae43e664919e%2Fprotected.png?alt=media) OnTextChanged(e) Fires the [TextChanged](https://docs.wisej.com/api/general/control#textchanged) event. | Parameter | Type | Description | | --------- | ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | **e** | [EventArgs](https://docs.microsoft.com/dotnet/api/system.eventargs) | A [EventArgs](https://docs.microsoft.com/dotnet/api/system.eventargs) that contains the event data. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) Validate() Causes validation to occur and returns whether validation was successful. **Returns:** [Boolean](https://docs.microsoft.com/dotnet/api/system.boolean). true if validation was successful and focus can shift to the [BindingNavigator](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.bindingnavigator); otherwise, false. ## Events ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) RefreshItems [EventHandler](https://docs.microsoft.com/dotnet/api/system.eventhandler) Fired when the state of the navigational user interface (UI) needs to be refreshed to reflect the current state of the underlying data source. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) TextChanged [EventHandler](https://docs.microsoft.com/dotnet/api/system.eventhandler) Fired when the value of the [Text](https://docs.wisej.com/api/containers/tabcontrol#text) property changes. ## Implements | Name | Description | | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | | [IUserData](https://docs.wisej.com/api/wisej.web/interfaces/wisej.web.iuserdata) | Provides access to the `UserData` and `Tag` properties associated to the component implementing this interface. | | [IBindableComponent](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.ibindablecomponent) | Bindable components implement this interface. | | [IDropTarget](https://docs.wisej.com/api/wisej.web/interfaces/wisej.web.idroptarget) | Controls that support drag & drop operations implement this interface. | | [IImage](https://docs.wisej.com/api/wisej.web/interfaces/wisej.web.iimage) | Provides access to common image properties across the controls that implement this interface. | | [IWisejComponent](https://docs.wisej.com/api/wisej.core/interfaces/wisej.core.iwisejcomponent) | All wisej components implement this interface. | | [IWisejControl](https://docs.wisej.com/api/wisej.core/interfaces/wisej.core.iwisejcontrol) | All wisej controls derived from the [Control](https://docs.wisej.com/api/wisej.web/general/control) class must implement this interface. | | [IWisejSerializable](https://docs.wisej.com/api/wisej.core/interfaces/wisej.core.iwisejserializable) | Allows an object to serialize itself. |