# BindingSource Namespace: **Wisej.Web** Assembly: **Wisej.Framework** (4.0.0.0) Encapsulates the data source for a data-bound component. {% tabs %} {% tab title="C#" %} ```csharp public class BindingSource : BindingSource, ICurrencyManagerProvider ``` {% endtab %} {% tab title="VB.NET" %} ```visual-basic Public Class BindingSource Inherits BindingSource Implements ICurrencyManagerProvider ``` {% 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) BindingSource() Initializes a new instance of the [BindingSource](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.bindingsource) class to the default property values. ### ![](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(container) Initializes a new instance of the [BindingSource](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.bindingsource) class and adds the [BindingSource](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.bindingsource) to the specified container. | Name | Type | Description | | ------------- | ------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **container** | [IContainer](https://docs.microsoft.com/dotnet/api/system.componentmodel.icontainer) | The [IContainer](https://docs.microsoft.com/dotnet/api/system.componentmodel.icontainer) to add the current [BindingSource](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.bindingsource) to. | ### ![](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(dataSource, dataMember) Initializes a new instance of the [BindingSource](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.bindingsource) class with the specified data source and data member. | Name | Type | Description | | -------------- | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | | **dataSource** | [Object](https://docs.microsoft.com/dotnet/api/system.object) | The data source for the [BindingSource](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.bindingsource). | | **dataMember** | [String](https://docs.microsoft.com/dotnet/api/system.string) | The specific column or list name within the data source to bind to. | ### ![](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(dataSource) Initializes a new instance of the [BindingSource](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.bindingsource) class with the specified data source. | Name | Type | Description | | -------------- | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | | **dataSource** | [Object](https://docs.microsoft.com/dotnet/api/system.object) | The data source for the [BindingSource](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.bindingsource). | ## 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) AllowEdit [Boolean](https://docs.microsoft.com/dotnet/api/system.boolean): Returns whether items in the underlying list can be edited. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) AllowNew [Boolean](https://docs.microsoft.com/dotnet/api/system.boolean): Returns or sets whether the [AddNew](#addnew) method can be used to add items to the list. **Throws:** * [InvalidOperationException](https://docs.microsoft.com/dotnet/api/system.invalidoperationexception) This property is set to true when the underlying list represented by the [List](#list) property has a fixed size or is read-only. * [MissingMethodException](https://docs.microsoft.com/dotnet/api/system.missingmethodexception) The property is set to true and the [AddingNew](#addingnew) event is not handled when the underlying list type does not have a default constructor. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) AllowRemove [Boolean](https://docs.microsoft.com/dotnet/api/system.boolean): Returns whether the items can be removed from the underlying list. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) Count [Int32](https://docs.microsoft.com/dotnet/api/system.int32): Returns the total number of items in the underlying list, filtered using the current [Filter](#filter) value. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) CurrencyManager [CurrencyManager](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.currencymanager): Returns the currency manager associated with this [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) Current [Object](https://docs.microsoft.com/dotnet/api/system.object): Returns the current item in the list. Use the [Current](#current) property to access the current item, but use the [List](#list) property to get the entire list. To determine the type of the current object, use the [GetType](https://docs.microsoft.com/dotnet/api/system.object.gettype), or [ToString](https://docs.microsoft.com/dotnet/api/system.object.tostring) methods. To change the current item, set the [Position](#position) property to a new integral value, or use one of the navigation methods such as [MoveNext](#movenext). ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) DataMember [String](https://docs.microsoft.com/dotnet/api/system.string): Returns or sets the list in the data source to which the connector currently binds to. (Default: `""`) If the [DataSource](#datasource) contains multiple lists (or tables) of data, you should set the [DataMember](#datamember) property to the name of one of the sources. Setting this property raises the [DataMemberChanged](#datamemberchanged) event ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) DataSource [Object](https://docs.microsoft.com/dotnet/api/system.object): Returns or sets the data source that the connector binds to. (Default: `null`) The [DataSource](#datasource) property can be set to a number of data sources, including types, objects, and lists of types. The resulting data source will be exposed as a list. The following table shows some of the common data sources and the resulting list evaluation. | DataSource | List Result | | ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | | null | An empty | | null with | Not supported, raises | | Non-list type or object of type "T" | Empty | | [Array](https://docs.microsoft.com/dotnet/api/system.array) | [IBindingList](https://docs.microsoft.com/dotnet/api/system.componentmodel.ibindinglist) | | [IEnumerable](https://docs.microsoft.com/dotnet/api/system.collections.ienumerable) | An | | List instance containing type "T" | [IBindingList](https://docs.microsoft.com/dotnet/api/system.componentmodel.ibindinglist) | In addition, [DataSource](#datasource) can be set to other list types such as [IListSource](https://docs.microsoft.com/dotnet/api/system.componentmodel.ilistsource) and [ITypedList](https://docs.microsoft.com/dotnet/api/system.componentmodel.itypedlist) and the [BindingSource](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.bindingsource) will handle them appropriately. In this case, the type contained in the list should have a parameterless constructor. When setting a data source, if the supplied reference contains more than one list or table, you must set the [DataMember](#datamember) property to a string that specifies the list to bind to. Setting this property raises the [DataSourceChanged](#datasourcechanged) event. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) Filter [String](https://docs.microsoft.com/dotnet/api/system.string): Returns or sets the expression used to filter the items in the underlying [List](#list). (Default: `null`) Typically used in complex data-binding scenarios, the [Filter](#filter) property allows you to view a subset of the [DataSource](#datasource). Only underlying lists that implement the [IBindingListView](https://docs.microsoft.com/dotnet/api/system.componentmodel.ibindinglistview) interface support filtering. When [Filter](#filter) is not null, the [BindingSource](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.bindingsource) passes this property to the underlying list. If you set this property during object initialization, the call will be deferred until after initialization is complete. To form a filter value, specify the name of a column followed by an operator and a value to filter on. The accepted filter syntax depends on the underlying data source. If the underlying data source is a [DataSet](https://docs.microsoft.com/dotnet/api/system.data.dataset), [DataTable](https://docs.microsoft.com/dotnet/api/system.data.datatable), or [DataView](https://docs.microsoft.com/dotnet/api/system.data.dataview), you can specify Boolean expressions using the syntax documented for the DataColumn.Expression property. The value of the Filter property affects the value of the [Count](#count) property. Additionally, the Filter value will persist when the data source changes. To stop filtering the [DataSource](#datasource), call the RemoveFilter method. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) IsBindingSuspended [Boolean](https://docs.microsoft.com/dotnet/api/system.boolean): Returns whether data binding is suspended. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) IsFixedSize [Boolean](https://docs.microsoft.com/dotnet/api/system.boolean): Returns whether the underlying [List](#list) has a fixed size. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) IsReadOnly [Boolean](https://docs.microsoft.com/dotnet/api/system.boolean): Return whether the underlying [List](#list) is read-only. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) IsSorted [Boolean](https://docs.microsoft.com/dotnet/api/system.boolean): Returns whether the items in the underlying [List](#list) are sorted. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) IsSynchronized [Boolean](https://docs.microsoft.com/dotnet/api/system.boolean): Returns whether access to the collection is synchronized (thread safe). ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) Item(index) [Object](https://docs.microsoft.com/dotnet/api/system.object): Returns or sets the list element at the specified index in the underlying [List](#list). **Throws:** * [ArgumentOutOfRangeException](https://docs.microsoft.com/dotnet/api/system.argumentoutofrangeexception) index is less than zero or is equal to or greater than [Count](#count). ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) List [IList](https://docs.microsoft.com/dotnet/api/system.collections.ilist): Returns the underlying data list. The [BindingSource](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.bindingsource) class uniformly handles different data sources. Ideally the [List](#list) property should be set to a general [IList](https://docs.microsoft.com/dotnet/api/system.collections.ilist). However, sometimes it may be necessary to cast this property to a more specific type. The following table shows the underlying list type, which depends on the type or value of the data source. | DataSource Type | Underlying List Description | | ------------------------- | ----------------------------------------------------------------------- | | [DataSource](#datasource) | An empty | | [DataSource](#datasource) | None; an attempt to get the List will throw an | | An | An | | An | The return value from a call to the GetList() method of this | | An | An | | An | An | | A non- | A | | An | An | | An | An | | The | A | | A Type that represents an | An instance created by a call to the CreateInstance(Type) method of the | | The | A | | The | None; an attempt to get the | If the type retrieved is the [IList](https://docs.microsoft.com/dotnet/api/system.collections.ilist) interface, the underlying collection may be more complex, such as an [ArrayList](https://docs.microsoft.com/dotnet/api/system.collections.arraylist) or [DataView](https://docs.microsoft.com/dotnet/api/system.data.dataview) class. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) Position [Int32](https://docs.microsoft.com/dotnet/api/system.int32): Returns or sets the index of the current item in the underlying [List](#list). (Default: `-1`) When setting the [Position](#position) property, out-of-range values are treated in the following manner: * Negative values are treated as 0. * Values greater than or equal to [Count](#count) are treated as Count minus 1. Changing the [Position](#position) property will adjust the [Current](#current) property. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) RaiseListChangedEvents [Boolean](https://docs.microsoft.com/dotnet/api/system.boolean): Returns or sets a value indicating whether [ListChanged](#listchanged) events should be raised. (Default: `True`) When the [RaiseListChangedEvents](#raiselistchangedevents) property is false, it suspends the raising of the [ListChanged](#listchanged) events. This event indicates that the bound list has been modified in some way, including adding, deleting, inserting, or modifying items. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) RefreshValueOnChange [Boolean](https://docs.microsoft.com/dotnet/api/system.boolean): Enables the automatic refresh of the source property after a data-bound value has been updated in the data source. (Default: `False`) This option fixes a long standing "feature" of the default BindingSource where the property that is the source of a value change is not refreshed automatically after it updates the bound data source. In a scenario where the data source "transforms" the value received from a data-bound control, the source property is not updated while all other bound properties are. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) Sort [String](https://docs.microsoft.com/dotnet/api/system.string): Returns or sets the column names used for sorting, and the sort order for viewing the rows in the data source. (Default: `null`) The [Sort](#sort) property is a case-sensitive string that specifies the column names used to sort the rows, along with the [SortDirection](#sortdirection). Columns are sorted ascending by default. Multiple columns can be separated by commas, such as "State, ZipCode DESC". To support sorting, the underlying [List](#list) must implement the [IBindingList](https://docs.microsoft.com/dotnet/api/system.componentmodel.ibindinglist) or [IBindingListView](https://docs.microsoft.com/dotnet/api/system.componentmodel.ibindinglistview) interfaces. This capability can be queried through the [SupportsSorting](#supportssorting) property. Multicolumn sorting is available when the [SupportsAdvancedSorting](#supportsadvancedsorting) property is true. Setting the Sort property will change the internal list depending on its type: * If the list is of type [IBindingList](https://docs.microsoft.com/dotnet/api/system.componentmodel.ibindinglist), the [SortProperty](https://docs.microsoft.com/dotnet/api/system.componentmodel.ibindinglist.sortproperty) and [SortDirection](https://docs.microsoft.com/dotnet/api/system.componentmodel.ibindinglist.sortdirection) properties are set in the internal list. * If the list is of type [IBindingListView](https://docs.microsoft.com/dotnet/api/system.componentmodel.ibindinglistview), the [SortDescriptions](https://docs.microsoft.com/dotnet/api/system.componentmodel.ibindinglistview.sortdescriptions) property is set. The internal list's sort properties are only changed when the sort string is not null. The get accessor for this property will not retrieve the sort value of the internal list; instead, it will return the set accessor value. The value of the [Sort](#sort) property will persist when the data source changes. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) SortDescriptions [ListSortDescriptionCollection](https://docs.microsoft.com/dotnet/api/system.componentmodel.listsortdescriptioncollection): Returns the collection of sort descriptions applied to the data source. If the data source is not an [IBindingListView](https://docs.microsoft.com/dotnet/api/system.componentmodel.ibindinglistview), the [SortDescriptions](#sortdescriptions) property always returns 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) SortDirection [ListSortDirection](https://docs.microsoft.com/dotnet/api/system.componentmodel.listsortdirection): Returns the direction the items in the underlying [List](#list) are sorted. If the data source is not an [IBindingList](https://docs.microsoft.com/dotnet/api/system.componentmodel.ibindinglist), the [SortDirection](#sortdirection) property always returns [Ascending](https://docs.microsoft.com/dotnet/api/system.componentmodel.listsortdirection.ascending). ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) SortProperty [PropertyDescriptor](https://docs.microsoft.com/dotnet/api/system.componentmodel.propertydescriptor): Returns the [PropertyDescriptor](https://docs.microsoft.com/dotnet/api/system.componentmodel.propertydescriptor) that is being used for sorting the underlying [List](#list). If the data source is not an [IBindingList](https://docs.microsoft.com/dotnet/api/system.componentmodel.ibindinglist), the [SortProperty](#sortproperty) property always returns 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) SupportsAdvancedSorting [Boolean](https://docs.microsoft.com/dotnet/api/system.boolean): Returns whether the data source supports multi-column sorting. If the data source is not an [IBindingListView](https://docs.microsoft.com/dotnet/api/system.componentmodel.ibindinglistview), the [SupportsAdvancedSorting](#supportsadvancedsorting) property always returns 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) SupportsChangeNotification [Boolean](https://docs.microsoft.com/dotnet/api/system.boolean): Return whether the data source supports change notification. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) SupportsFiltering [Boolean](https://docs.microsoft.com/dotnet/api/system.boolean): Returns whether the data source supports filtering. If the data source is not an [IBindingList](https://docs.microsoft.com/dotnet/api/system.componentmodel.ibindinglist), the [SupportsFiltering](#supportsfiltering) property always returns 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) SupportsSearching [Boolean](https://docs.microsoft.com/dotnet/api/system.boolean): Returns whether the data source supports searching with the [Find](#find-propertyname-value) method. If the data source is not an [IBindingList](https://docs.microsoft.com/dotnet/api/system.componentmodel.ibindinglist), the [SupportsSearching](#supportssearching) property always returns 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) SupportsSorting [Boolean](https://docs.microsoft.com/dotnet/api/system.boolean): Returns whether the data source supports sorting. If the data source is not an [IBindingList](https://docs.microsoft.com/dotnet/api/system.componentmodel.ibindinglist), the [SupportsSorting](#supportssorting) property always returns 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) SyncRoot [Object](https://docs.microsoft.com/dotnet/api/system.object): Returns an object used to synchronize access to the underlying [List](#list). ## 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) Add(item) Adds an existing item to the underlying [List](#list). | Parameter | Type | Description | | --------- | ------------------------------------------------------------- | ----------------------------------------- | | **item** | [Object](https://docs.microsoft.com/dotnet/api/system.object) | Item to add the underlying [List](#list). | **Returns:** [Int32](https://docs.microsoft.com/dotnet/api/system.int32). The index at which the *item* was added to the underlying [List](#list). ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) AddNew() Adds a new item to the underlying [List](#list). **Returns:** [Object](https://docs.microsoft.com/dotnet/api/system.object). The object that was created and added to the underlying [List](#list). ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) ApplySort(property, sort) Sorts the data source using the specified *property* descriptor and *sort* direction. | Parameter | Type | Description | | ------------ | ---------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **property** | [PropertyDescriptor](https://docs.microsoft.com/dotnet/api/system.componentmodel.propertydescriptor) | A [PropertyDescriptor](https://docs.microsoft.com/dotnet/api/system.componentmodel.propertydescriptor) that describes the property by which to sort the data source. | | **sort** | [ListSortDirection](https://docs.microsoft.com/dotnet/api/system.componentmodel.listsortdirection) | A [ListSortDescription](https://docs.microsoft.com/dotnet/api/system.componentmodel.listsortdescription) indicating how the list should be sorted. | The [IBindingList](https://docs.microsoft.com/dotnet/api/system.componentmodel.ibindinglist) implements single column sorting using a [PropertyDescriptor](https://docs.microsoft.com/dotnet/api/system.componentmodel.propertydescriptor) to indicate a property to sort by and a [ListSortDirection](https://docs.microsoft.com/dotnet/api/system.componentmodel.listsortdirection) indicating whether the property contents should be sorted in ascending or descending order. **Throws:** * [NotSupportedException](https://docs.microsoft.com/dotnet/api/system.notsupportedexception) The data source is not an [IBindingList](https://docs.microsoft.com/dotnet/api/system.componentmodel.ibindinglist). ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) ApplySort(sorts) Sorts the data source with the specified sort descriptions. | Parameter | Type | Description | | --------- | -------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **sorts** | [ListSortDescriptionCollection](https://docs.microsoft.com/dotnet/api/system.componentmodel.listsortdescriptioncollection) | A [ListSortDescriptionCollection](https://docs.microsoft.com/dotnet/api/system.componentmodel.listsortdescriptioncollection) containing the sort descriptions to apply to the data source. | [IBindingListView](https://docs.microsoft.com/dotnet/api/system.componentmodel.ibindinglistview) implements multi-column sorting as a set of property descriptor-direction pairs. **Throws:** * [NotSupportedException](https://docs.microsoft.com/dotnet/api/system.notsupportedexception) The data source is not an [IBindingListView](https://docs.microsoft.com/dotnet/api/system.componentmodel.ibindinglistview). ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) CancelEdit() Cancels the current edit operation. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) Clear() Removes all elements from the list. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) Contains(item) Determines whether the *item* is present in he underlying [List](#list). | Parameter | Type | Description | | --------- | ------------------------------------------------------------- | ----------------------------------------------- | | **item** | [Object](https://docs.microsoft.com/dotnet/api/system.object) | Item to locate in the underlying [List](#list). | **Returns:** [Boolean](https://docs.microsoft.com/dotnet/api/system.boolean). true if the *item* is found in the [List](#list). ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) CopyTo(array, index) Copies the contents of the [List](#list) to the specified *array* , starting at the specified *index* value. | Parameter | Type | Description | | --------- | ----------------------------------------------------------- | -------------------------------------------------------------- | | **array** | [Array](https://docs.microsoft.com/dotnet/api/system.array) | The destination array. | | **index** | [Int32](https://docs.microsoft.com/dotnet/api/system.int32) | The index in the destination array at which to start the copy. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) EndEdit() Applies pending changes to the underlying data source. When the [EndEdit](#endedit) method is called, all pending changes are applied to the underlying data source. This method has no effect unless the objects contained by the data source implement the [IEditableObject](https://docs.microsoft.com/dotnet/api/system.componentmodel.ieditableobject) interface. If the objects do not implement the [IEditableObject](https://docs.microsoft.com/dotnet/api/system.componentmodel.ieditableobject) interface, changes to the data are copied to the underlying data source immediately after each change. This method raises the [ListChanged](#listchanged) event. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) Find(propertyName, value) Returns the index of the item in the list with the specified *propertyName* and *value* . | Parameter | Type | Description | | ---------------- | ------------------------------------------------------------- | ---------------------------------------------------------------- | | **propertyName** | [String](https://docs.microsoft.com/dotnet/api/system.string) | The name of the property to search. | | **value** | [Object](https://docs.microsoft.com/dotnet/api/system.object) | The value of the item with the specified *propertyName* to find. | **Returns:** [Int32](https://docs.microsoft.com/dotnet/api/system.int32). The zero-based index of the item with the specified *propertyName* and *value* . **Throws:** * [InvalidOperationException](https://docs.microsoft.com/dotnet/api/system.invalidoperationexception) The underlying list is not a [IBindingList](https://docs.microsoft.com/dotnet/api/system.componentmodel.ibindinglist) with searching functionality implemented. * [ArgumentException](https://docs.microsoft.com/dotnet/api/system.argumentexception) *propertyName* does not match a property in the list. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) Find(property, value) Searches for the index of the that has the given *value* in the specified *property* . | Parameter | Type | Description | | ------------ | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | | **property** | [PropertyDescriptor](https://docs.microsoft.com/dotnet/api/system.componentmodel.propertydescriptor) | The [PropertyDescriptor](https://docs.microsoft.com/dotnet/api/system.componentmodel.propertydescriptor) to search. | | **value** | [Object](https://docs.microsoft.com/dotnet/api/system.object) | The value of the *property* to match. | **Returns:** [Int32](https://docs.microsoft.com/dotnet/api/system.int32). The index of the item that has the given *value* . **Throws:** * [ArgumentException](https://docs.microsoft.com/dotnet/api/system.argumentexception) *property* does not match a property in the list. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) GetCommandProperties() Retrieves the collection of [PropertyDescriptor](https://docs.microsoft.com/dotnet/api/system.componentmodel.propertydescriptor) objects representing the bindable [ICommand](https://docs.wisej.com/api/wisej.web/interfaces/wisej.web.icommand) properties defined on the [DataSource](#datasource) object. **Returns:** [PropertyDescriptorCollection](https://docs.microsoft.com/dotnet/api/system.componentmodel.propertydescriptorcollection). An collection of [PropertyDescriptor](https://docs.microsoft.com/dotnet/api/system.componentmodel.propertydescriptor) objects that represents the commands on the 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) GetEnumerator() Retrieves an enumerator for the underlying [List](#list). **Returns:** [IEnumerator](https://docs.microsoft.com/dotnet/api/system.collections.ienumerator). An [IEnumerator](https://docs.microsoft.com/dotnet/api/system.collections.ienumerator) for the [List](#list). ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) GetItemProperties(listAccessors) Retrieves an collection of [PropertyDescriptor](https://docs.microsoft.com/dotnet/api/system.componentmodel.propertydescriptor) objects representing the bindable properties of the data source list type. | Parameter | Type | Description | | ----------------- | -------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | | **listAccessors** | [PropertyDescriptor\[\]](https://docs.microsoft.com/dotnet/api/system.componentmodel.propertydescriptor) | An array of [PropertyDescriptor](https://docs.microsoft.com/dotnet/api/system.componentmodel.propertydescriptor) objects to find in the [List](#list) type. | **Returns:** [PropertyDescriptorCollection](https://docs.microsoft.com/dotnet/api/system.componentmodel.propertydescriptorcollection). An collection of [PropertyDescriptor](https://docs.microsoft.com/dotnet/api/system.componentmodel.propertydescriptor) objects that represents the properties on this list type used to bind 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) GetListName(listAccessors) Returns the name of the list supplying data for the binding operations. | Parameter | Type | Description | | ----------------- | -------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | **listAccessors** | [PropertyDescriptor\[\]](https://docs.microsoft.com/dotnet/api/system.componentmodel.propertydescriptor) | An array of [PropertyDescriptor](https://docs.microsoft.com/dotnet/api/system.componentmodel.propertydescriptor) objects to find in the list as bindable. | **Returns:** [String](https://docs.microsoft.com/dotnet/api/system.string). The name of the list supplying the data for binding operations. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) GetRelatedCurrencyManager(dataMember) Returns the related [CurrencyManager](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.currencymanager) for the specified data member. | Parameter | Type | Description | | -------------- | ------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | | **dataMember** | [String](https://docs.microsoft.com/dotnet/api/system.string) | The name of column or list, within the data source to retrieve the currency manager for. | **Returns:** [CurrencyManager](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.currencymanager). The related [CurrencyManager](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.currencymanager) for the specified data member. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) IndexOf(item) Returns the index of the specified *item* in the underlying [List](#list). | Parameter | Type | Description | | --------- | ------------------------------------------------------------- | --------------- | | **item** | [Object](https://docs.microsoft.com/dotnet/api/system.object) | item to locate. | **Returns:** [Int32](https://docs.microsoft.com/dotnet/api/system.int32). The index of the first occurrence of *item* in the [List](#list). ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) Insert(index, item) Inserts an *item* into the [List](#list) at the specified *index* . | Parameter | Type | Description | | --------- | ------------------------------------------------------------- | ---------------------------------- | | **index** | [Int32](https://docs.microsoft.com/dotnet/api/system.int32) | Index at which to insert the item. | | **item** | [Object](https://docs.microsoft.com/dotnet/api/system.object) | Item to insert, it can be null. | **Throws:** * [ArgumentOutOfRangeException](https://docs.microsoft.com/dotnet/api/system.argumentoutofrangeexception) index is less than zero or greater than [Count](#count). * [NotSupportedException](https://docs.microsoft.com/dotnet/api/system.notsupportedexception) The list is read-only or has a fixed size. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) MoveFirst() Moves the current position to the first item in the [List](#list). ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) MoveLast() Moves the current position to the last item in the [List](#list). ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) MoveNext() Moves the current position to the next item in the [List](#list). ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) MovePrevious() Moves the current position to the previous item in the [List](#list). ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-9bf7fa01e02f4da0f9ef90d3b049ae43e664919e%2Fprotected.png?alt=media) OnAddingNew(e) Fires the [AddingNew](#addingnew) event. | Parameter | Type | Description | | --------- | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | | **e** | [AddingNewEventArgs](https://docs.microsoft.com/dotnet/api/system.componentmodel.addingneweventargs) | A [AddingNewEventArgs](https://docs.microsoft.com/dotnet/api/system.componentmodel.addingneweventargs) 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) OnBindingComplete(e) Fires the [BindingComplete](#bindingcomplete) event. | Parameter | Type | Description | | --------- | ---------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | | **e** | [BindingCompleteEventArgs](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.bindingcompleteeventargs) | A [BindingCompleteEventArgs](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.bindingcompleteeventargs) 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) OnCurrentChanged(e) Fires the [CurrentChanged](#currentchanged) 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) OnCurrentItemChanged(e) Fires the [CurrentItemChanged](#currentitemchanged) 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) OnDataError(e) Fires the [DataError](#dataerror) event. | Parameter | Type | Description | | --------- | -------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **e** | [BindingManagerDataErrorEventArgs](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.bindingmanagerdataerroreventargs) | A [BindingManagerDataErrorEventArgs](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.bindingmanagerdataerroreventargs) 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) OnDataMemberChanged(e) Fires the [DataMemberChanged](#datamemberchanged) 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) OnDataSourceChanged(e) Fires the [DataSourceChanged](#datasourcechanged) 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) OnListChanged(e) Fires the [ListChanged](#listchanged) event. | Parameter | Type | Description | | --------- | -------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | | **e** | [ListChangedEventArgs](https://docs.microsoft.com/dotnet/api/system.componentmodel.listchangedeventargs) | A [ListChangedEventArgs](https://docs.microsoft.com/dotnet/api/system.componentmodel.listchangedeventargs) 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) OnPositionChanged(e) Fires the [PositionChanged](#positionchanged) 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-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) Remove(item) Removes the specified *item* from the [List](#list). | Parameter | Type | Description | | --------- | ------------------------------------------------------------- | --------------- | | **item** | [Object](https://docs.microsoft.com/dotnet/api/system.object) | Item to remove. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) RemoveAt(index) Removes the item at the specified *index* from the [List](#list). | Parameter | Type | Description | | --------- | ----------------------------------------------------------- | ---------------------------- | | **index** | [Int32](https://docs.microsoft.com/dotnet/api/system.int32) | Index of the item to remove. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) RemoveCurrent() Removes the current item from the [List](#list). ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) RemoveFilter() Removes the filter associated with this [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) RemoveSort() Removes the sort information associated with this [BindingSource](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.bindingsource). **Throws:** * [NotSupportedException](https://docs.microsoft.com/dotnet/api/system.notsupportedexception) The underlying data source does not support sorting. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) ResetBindings() Causes a control bound to this [BindingSource](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.bindingsource) to re-read all the items and refresh their displayed value. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) ResetBindings(metadataChanged) Causes a control bound to this [BindingSource](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.bindingsource) to re-read all the items and refresh their displayed value. | Parameter | Type | Description | | ------------------- | --------------------------------------------------------------- | ------------------------------------------------------------------- | | **metadataChanged** | [Boolean](https://docs.microsoft.com/dotnet/api/system.boolean) | true if the schema has changed; false if only the data has changed. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) ResetCurrentItem() Causes a control bound to this [BindingSource](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.bindingsource) to re-read the current item and refresh the displayed value. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) ResetItem(itemIndex) Causes a control bound to this [BindingSource](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.bindingsource) to read the item at the specified *itemIndex* and refresh the displayed value. | Parameter | Type | Description | | ------------- | ----------------------------------------------------------- | --------------------------------------- | | **itemIndex** | [Int32](https://docs.microsoft.com/dotnet/api/system.int32) | The index of the item that has changed. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) ResumeBinding() Resumes data binding. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) SuspendBinding() Suspends data binding to prevent changes from updating the data-bound data source. ## 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) AddingNew [AddingNewEventHandler](https://docs.microsoft.com/dotnet/api/system.componentmodel.addingneweventhandler) Fired before an item is added to the underlying [List](#list). ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) BindingComplete [BindingCompleteEventHandler](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.bindingcompleteeventhandler) Fired when all the clients have been bound to this [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) CurrentChanged [EventHandler](https://docs.microsoft.com/dotnet/api/system.eventhandler) Occurs when the currently bound item changes. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) CurrentItemChanged [EventHandler](https://docs.microsoft.com/dotnet/api/system.eventhandler) Occurs when a property value of the [Current](#current) property has changed. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) DataError [BindingManagerDataErrorEventHandler](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.bindingmanagerdataerroreventhandler) Fired when a currency-related exception is silently handled by the [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) DataMemberChanged [EventHandler](https://docs.microsoft.com/dotnet/api/system.eventhandler) Fired when the [DataMember](#datamember) property value has changed. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) DataSourceChanged [EventHandler](https://docs.microsoft.com/dotnet/api/system.eventhandler) Fired when the [DataSource](#datasource) property value has changed. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) ListChanged [ListChangedEventHandler](https://docs.microsoft.com/dotnet/api/system.componentmodel.listchangedeventhandler) Fired when the underlying [List](#list) changes or an item in the list changes. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) PositionChanged [EventHandler](https://docs.microsoft.com/dotnet/api/system.eventhandler) Fired after the value of the [Position](#position) property has changed. ## Implements | Name | Description | | ---------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- | | [ICurrencyManagerProvider](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.icurrencymanagerprovider) | Provides custom binding management for components. |