The client binding architecture implemented in WebCombo is consisted of a set of comprehensive new classes, methods and interfaces to enable programmatic consumption in the most elegant fashion. The user interface functions and high-level encapsulation of the binding process actually called the same underlying APIs.
This topic explains the new public methods and events which are available when client binding mode is enabled, and the data source type is set to either client services or client data source.
New Methods
Several methods have been added to the WebCombo class as extensions to provide programmatic client binding functionality. These methods will only be available when client binding feature is enabled.
| New Methods | Parameters | Description |
|---|---|---|
| SetDataSource | dataSource, tableName | Assigns a new client-side datasource to WebCombo. |
| GetConvertedDataSource | - | Gets the datasource that has been converted to CDOF-compatible object. |
| DataBind | - | Instructs WebCombo to perform data binding based on assigned datasource. |
| LoadData | - | Instructs WebCombo to perform initial data loading. |
| Render | - | Perform rendering based on bound data. |
| RebindData | dataSource, skipDataDispatch | Rebind WebCombo with a new datasource. |
| DispatchDataTable | - | Gets the CDOF data table object. |
| GetView | - | Gets the CDOF data view object. |
| GetFilterExpression | - | Gets the filter expression required to construct the view for this table. |
| WebComboRow.CopyTo | targetObject, isModifiedOnly, followTargetStructure | Copies the WebComboRow properties and data to the destination object. |
New Events
The following table describes the new client side events related to client binding feature.
| Event Name | Parameters | Description |
|---|---|---|
|
OnInitializeRow |
controlId, row |
Fired when a row is initialized. |
|
OnInitializeCell |
controlId, cell |
Fired when a cell is initialized. |
|
OnDataSourceChanged |
controlId |
Fired when data source has been changed. |
|
OnDataBound |
controlId |
Fired when data binding process is completed. |
|
OnPreRender |
controlId |
Fired before WebGrid enters rendering phase. |
|
OnPostRender |
controlId |
Fired after rendering operation is completed. |