FieldFilter 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

Field

Specifies the database field to which the filter applies.

Applies To

Dropdown List
Text Box

FilterOperator

Specifies the type of filtering operation to apply to the field.  Values include any of the comparison operations such as =, !=, <, <=, >, >=, etc.

Applies To

Dropdown List
Text Box

MaxDisplayedValues

Sets the maximum number of values displayed in a filter list.  This keeps a filter list from becoming excessively large.

Applies To

Dropdown List

ASP.NET Control Properties

The ASP.NET controls have a wide variety of properties that can be used to govern the controls’ behaviors.  You can enter any .NET control property into the Attributes tab and Iron Speed Designer will insert them into the generated control tags.

Pass-Through Attribute

Description

<TextBox Control Name>FilterTextBox:Columns

Specifies the screen width of the text box if the style indicates the field filter is a text box.

Applies To

Text Box

AutoPostBack

True

Automatically post back to the server application when the selected value is changed.  For example, when changing the selected value in a dropdown list filter, the associated table control is automatically updated with the new filter value applied.

False

Do not post back to the server application when the selected value is changed.  This requires the user to click a button or link to initiate the postback, and is typically used in situations where application users must select multiple filter values before the associated table control data is updated.

The default behavior for dropdown filters generated by Iron Speed Designer is to postback an event immediately when a new selection is made.  This sometimes becomes inconvenient when there are multiple filters and the end users would prefer to select from multiple filters first, and then press a Go button to begin the process of filtering.

If you have a “Go” button to start the filtering process (AutoPostBack = False), your application must instruct the table control to update itself when the user presses the Go button.  However, instead of notifying the table control, it’s better to notify the filter control(s) and let it (them) forward the message to the table control.  This ensures that the table control gets notified by the filter control rather than from the button control.

Applies To

Dropdown list

See also

Pass-Through Attributes

FieldFilter Tag