Table Pass-Through Attribute Properties

Iron Speed Designer Pass-Through Attributes

These attributes control specific types of controls generated by Iron Speed Designer. Generally these attributes govern specific portions of code that is generated for your application depending on the selected attributes and their values.

Pass-Through Attribute

Description

DataReaderAlwaysSortBy

When the table is initially displayed, the data is sorted by a secondary sorting criteria, DataReaderAlwaysSortBy, which is applied after the DataReaderSortBy criteria.

DataReaderAlwaysSortBy only affects the sort order when the DataReaderSortBy ordering would be satisfied by more than one permutation of the data items. That is, the DataReaderAlwaysSortBy is a "tie-breaker" sort order. For example, DataReaderSortBy="ProductID" will always establish a unique sort order since ProductID is unique, and DataReaderAlwaysSortBy will not have any effect. However, SortBy="UnitPrice" may not establish a unique sort order since several products could have the same price. So DataReaderSortBy="UnitPrice" and DataReaderAlwaysSortBy="ProductName" will sort all products by Price first, and all products with the same Price would then be sorted by Name.

Applies To

Table

DataReaderSortBy

When the table is initially displayed, the data is sorted according to the field specified by DataReaderSortBy.

Applies To

Table

PageSize

The default number of data rows to display within the table at one time. Typically, this numeric value is displayed in the Pagination control associated with the table and can be adjusted at run-time by the application user.

To get an unlimited number of records to be displayed on the page, set the Default Table Size to -1.

Applies To

Table

SmoothPanelUpdate

Controls the generation of Ajax-based panel update code for Table and Record controls.

True	Ajax-based smooth panel updating is enabled.
False	Ajax-based smooth panel updating is disabled.

If SmoothPanelUpdate is not present, then smooth panel updating is disabled.

Applies To	Record Table
Other	.NET Framework 2.0 and later applications.

Smooth Panel Update Limitations for Nested Tables

Not all .NET controls are compatible with the smooth panel update feature, which is implemented, in part, using the Ajax UpdatePanel control. These .NET controls are known to not be compatible with the smooth panel update feature:

DetailsView when their EnableSortingAndPagingCallbacks is also set to True
GridView when their EnableSortingAndPagingCallbacks is also set to True
Login, PasswordRecovery, ChangePassword and CreateUserWizard controls whose contents have not been converted to editable templates
FileUpload controls
Menu controls
Substitution controls
TreeView controls
Validation controls.
Web parts controls.

In addition to the above controls, any button control which performs a file download will not work when used with the smooth panel update feature. To solve this problem, add the PostBack pass-through attribute to the button control in Iron Speed Designer (Poperties dialog, Attributes tab) and set it to ‘True’.

Controls not compatible with the .NET UpdatePanel control can still be used in a page but must be placed outside of the UpdatePanel controls. Some controls can be used within the UpdatePanel control, but only if they are used in specific ways. To find out more information, please refer the section “Controls that Are Not Compatible with UpdatePanel Controls” in:

http://ajax.asp.net/docs/overview/UpdatePanelOverview.aspx

According to Microsoft:

All other controls work inside UpdatePanel controls. However, in some circumstances, a control might not work as expected inside an UpdatePanel control. These circumstances include the following:

Registering script by calling registration methods of the ClientScriptManager control.
Rendering script or markup directly during control rendering, such as by calling the Write(String) method.

If the control calls script registration methods of the ClientScriptManager control, you could use corresponding script registration methods of the ScriptManager control instead. In that case, the control can work inside an UpdatePanel control.

Nested UpdatePanel controls trigger traditional postbacks only in the outermost UpdatePanel control. Hence, only button controls cointained within the outermost UpdatePanel control may have their PostBack pass-through attribute set to True. All button controls nested inside inner UpdatePanel controls can refresh the UpdatePanel control only by performing an asynchronous postback; they may not have their PostBack pass-through attribute set to True.

Smooth Panel Update Limitations with View State Options

In some cases, certain actions will not work when Smooth Panel Update is enabled for a control and the View State is set other than to ‘Page’. These are known to be problematic:

Clicking the ‘Save’ button when adding data to a Table panel will not save the data entered when View State is set to Session. Set the View State to ‘Page’ to enable data saving.
Selecting a value in a dropdown list box can cause a page to go ‘blank’.

In situations such as these, either disable Smooth Panel Update on the affected controls or set the View State to ‘Page’ (Build, Performance Tuning…).

Table Pass-Through Attribute Properties

Iron Speed Designer Pass-Through Attributes

Smooth Panel Update Limitations for Nested Tables

Smooth Panel Update Limitations with View State Options

See also