FieldValue Pass-Through Attributes

CheckedValue

This pass-through attribute specifies the value saved into the database when a selected check box field is saved.  CheckedValue is generally set to ‘Yes’.  While CheckedValue can be set to anything, typical values are True, T, Yes, and 1.

Consumers

See Button Tag Pass-Through Attributes for details.

DataFormat

Specifies the display format of the data displayed in the control.

DateSelectorType

Displays a calendar date selector control for Date fields.  A Date Selector control presents a calendar-like interface that lets application users select date values.

The calendar’s date format is determined by the “culture” attribute in your application’s Web.config file, e.g.:

<globalization fileEncoding="utf-8" requestEncoding="utf-8" responseEncoding="utf-8" culture="en-US" . . .

You can set the culture attribute on the Languages step in the Application Wizard.

EnableIncrementDecrementButtons

Increment and decrement buttons are enabled by default if this pass-through attribute is not present.  You must explicitely set this attribute to False if you do not want increment and decement buttons for the designated field.

You can globally disable the generation of increment and decrement buttons in the Application Generation Options dialog (Tools, Application Generation Options...).  If disabled globally in the Application Generation Options dialog, no increment and decrement buttons will be generated anywhere in your application regardless of the EnableIncrementDecrementButtons pass-through attribute setting for any individual FieldValue tag.

FieldMaxLength

Specifies the number of characters displayed on a web page for a text field, limiting the display of long ‘note’ fields in order to conserve screen real estate.

Use with PopupDisplay pass-through attribute

FieldMaxLength may be used in conjunction with the PopupDisplay pass-through attribute to display a limited amount of text on the web page and complete text in the pop-up.

FieldMaxLength also governs the number of characters displayed in PDF Reports generated by Iron Speed Designer (PDF Report).

Any positive integer may be specified; the lowest permitted value is 1.  Several special values are permitted:

The default value is the “Default”.  If any invalid value is specified (e.g., 0 or negative number), then all characters in the field are displayed on the web page.

Field contents are truncated and HTML tags do not render properly

The contents of a rich text field will be truncated if FieldMaxLength is less than the length of the contents in the field.  If the contents of a rich text field are truncated, various HTML tags may be displayed rather than rendered as HTML.  To “remove” the HTML tags from displaying, increase FieldMaxLength to exceed the length of the contents stored in the field or the length of the database field itself.

FilenameField

Used for the File Download and FileUpload controls.  Specifies the companion database field containing the file name of the downloaded or uploaded file.  The companion database field must be in the same table as the field containing the actual file contents.

For File Download, the value of this field displays a file download link that when clicked opens (downloads) the file.

For File Upload, the file name of the uploaded file is stored in this field.

HTMLEncodeValue

Specifies how to display text contained in the field.  If a field contains HTML code, you can configure the field to render (display) the HTML rather than display ‘raw’ unrendered text.

HtmlEncodeWhiteSpace

ImageHeight
ImageWidth

Specifyies the displayed image size in pixels.  When specified, images are not displayed at their normal size but are scaled according to the sizes specified by ImageWidth and ImageHeight.  Both ImageWidth and ImageHeight must be provided in order to specify the image size in pixels.  ImageWidth and ImageHeight are used in conjunction with the PopupDisplay pass-through attribute.

ImageWidth and ImageHeight may be used when ImagePercentSize is not specified.  Any positive integer value may be specified.  No default value is assumed for these pass-through attributes.

ImagePercentSize has higher priority over ImageWidth and ImageHeight.  If all three are specified then the image will be displayed according to the ImagePercentSize value.  If the ImagePercentSize pass-through attribute is missing, ImageWidth and ImageHeight values are used.

ImagePercentSize

Specifies the size of the thumbnail image displayed on a web page.  When specified, images are not displayed at their normal size but are scaled according to the percentage specified by ImagePercentSize.  ImagePercentSize is used in conjunction with the PopupDisplay pass-through attribute.

ImagePercentSize specifies a percentage of the image’s actual size.  Any positive number starting from 0.0 may be specified.  Values less than 1.0 are taken as an actual percentage.  For example, a value of 0.3 is interpreted as 30% and the image will be displayed with 30% of its original size.

The default value for ImagePercentSize is the “default” string which represents a default value, typically 20%.

LoadData

Example #1:

To set an date updated audit field every time the page is edited, set the date field’s initial value to “DateTime.Now()” and set the LoadData pass-through attribute to ‘False’.

Example #1:

To initialize a field’s value if no value is present in the database, set the field’s initial value to the value you want, and set the LoadData pass-through attribute to ‘True’.  If the value exists in the database, it will be used.  If no value is present in the database, the initial value is used.

MaxGeneratedItems

Specifies the maximum number of values that will be automatically populated in list-style controls, such as dropdown lists and list boxes.  The default value used by Iron Speed Designer is 500 entries.  However, you can change this threshold to any value desired on a control-by-control basis with MaxGeneratedItems.

Note:  If the number of entries at run-time exceeds the value of the MinListItems pass-through attribute, a More link will be placed next to the field that, when clicked, displays the Large List Selector.  If the MinListItems is not specified, then MaxGeneratedItems is used as the Large List Selector threshold.

If you wish to disable the Large List Selector for a particular control, set MinListItems to a very large value.

MinListItems

Specifies the minimum number of items required before the large list selector control is automatically displayed along side the FieldValue component.  MinListItems applies only when the FieldValue tag’s control type is Dropdown List.

MinListItems can be used in conjunction with MaxGeneratedItems to construct various scenarios.  For example, you can set MaxGeneratedItems to 500 and MinListItems to 100.  In this case, the dropdown list will contain upto 500 items but the large list selector’s “More” link will appear next to the control once the 100 item threshold is reached.

NullValueText

Specifies the text to be displayed or inserted into the database if the underlying database field has a “null” value (no value).  This is typically set to ‘&nbsp;’

PopupDisplay

Enables Ajax-based text and image pop-ups for the field.

Text pop-ups

Text pop-ups are displayed if the underlying database field type is a string or character field.  The PopupThreshold pass-through attribute specifies when text pop-ups will be displayed.

If the field’s Validation Type is Password, then no pop-up is displayed.

Image pop-ups

Image pop-ups are displayed only if the Control Type is ‘Image’.

If the underlying database field type is a string, no image scaling will occur on the underlying web page because the field is assumed to contain a URL and not the binary contents of an image.  However, the pop-up will be displayed.

Browser requirements

Text and image pop-ups require Internet Explorer 7 or later.

See Browser requirements for text and image pop-ups for details.

PopupThreshold

Controls when an Ajax-enabled text pop-up should be displayed.  The text pop-up will be displayed if the number of characters in the individual database record exceeds PopupThreshold.  PopupThreshold is used in conjunction with the PopupDisplay pass-through attribute.

The default value is the “default” string which represents the default value, typically 100 characters.  Any positive integer may be specified.  A text pop-up is always displayed if any invalid value is specified (e.g., characters or negative numbers).

PopupWindowPersist

Controls the persistence of a pop-up window.  PopupWindowPersist is used in conjunction with the PopupDisplay pass-through attribute.

If PopupWindowPersist is not specified, then ‘False’ is assumed.

PopupWindowScrollBar

Enables scroll bars in a pop-up.  PopupWindowScrollBar is used in conjunction with the PopupDisplay pass-through attribute.

If PopupWindowScrollBar is not present, the default value ‘True’ is assumed.

PopupWindowTitle

Provides the title for the pop-up window.  PopupWindowTitle is used in conjunction with the PopupDisplay pass-through attribute.

The default value is:  %ISD_DEFAULT%

This represents the column name in the database.  Valid input can be any text.  If PopupWindowTitle is not present, then no title will be displayed.

PopupWindowWidth
PopupWindowHeight

Specifies the pop-up window width and height.  Any positive integer value may be specified.  PopupWindowWidth and PopupWindowHeight are used in conjunction with the PopupDisplay pass-through attribute.

The default PopupWindowHeight value is 200 pixels.  The default PopupWindowWidth value is 300 pixels.  If PopupWindowWidth and PopupWindowHeight are not present, then their default values are used.

RequiredRoles

Ay security roles configured for an individual field.  Individual roles are separated by a semi-colon (‘;’) and are wrapped in tags corresponding to the role management type.

RichTextEditorHeight

Specifies the height of the editor control window in pixels.

RichTextEditorShowToolbar

Specifies whether editor’s menu toolbar should be shown or hidden when the record or table is opened for editing.

RichTextEditorType

Specifies which text editor control to generate.

RichTextEditorWidth

Specifies the width of the editor control window in pixels.

SaveData

Forces or suppresses saving the field’s data to the database.

The SaveData pass-through attribute defaults to “True” for some controls and to “False” for others.  Other controls, such as the Link Button, don’t allow SaveData to be set to True.

TextFormat

Formats text before it is displayed on the web page.

See TextFormat pass-through attribute for details.

TreatOtherValuesAsChecked

Check box fields can be displayed as either selected (checked) or unselected (unchecked).  The CheckedValue and UncheckedValue pass-through attributes designate the database values that signify whether the check box should be selected.  These are typically values such as ‘True’ and ‘False’ or ‘1’ and ‘0’.

In some cases, the underlying database field may have values other than those specified by the CheckedValue and UncheckedValue pass-through attributes, e.g., the values may be ‘True’, ‘False’, and ‘Not Sure’.  The TreatOtherValuesAsChecked pass-through attribute specifies whether a check box field is displayed as selected when these other values are encountered in the database.

If a hypothetical database column has a value of ‘Not Sure’, then the check box would be shown as checked if the TreatOtherValuesAsChecked pass-through attribute is set to ‘True’.  The check box would be shown as unchecked if the TreatOtherValuesAsChecked pass-through attribute is set to ‘False.’

UncheckedValue

This pass-through attribute specifies the value saved into the database when an unselected check box field is saved.  UncheckedValue is generally set to ‘No’.  While UncheckedValue can be set to anything, typical values are False, F, No, and 0.

Specify a prefix or suffix

Phone: {0}

{0} (fax)

Format values with color, bold and underline

<font color=”red”><b><u>{0}</u></b></font>

Mailto hyperlink

<a href='mailto:{0}'>{0}</a>

Hyperlink a database field

<a href=’{0}’>Click Here</a>

<a href=’{0}’>{0}</a>

HtmlEncodeValue

False

PopupDisplay

False

FieldMaxLength

An integer value greather than the length of the text so that all text including embedded HTML tags is displayed

PopupThreshold

A large integer value

<Tag Name>
RequiredFieldValidator:Display

Specifies whether the space for the validation text and error message is pre-reserved or allocated dynamically at run-time.

Example:

            OrderDateRequiredFieldValidator:Display

<Tag Name>
RequiredFieldValidator:Enabled

Specifies whether an input value is required for the control.

Example:

            OrderDateRequiredFieldValidator:Enabled

<Tag Name>
RequiredFieldValidator:InitialValue

Specifies a value for the ‘NO-SELECTION’ entry for dropdown lists.  The InitialValue pass-through attribute applies only when the RequiredFieldValidator:Enabled pass-through attribute is set to ‘True’.  Upon saving, the selected value is compared to the InitialValue, and if they are the same, an error is displayed to the user requesting they select a value.

<Tag Name>
RequiredFieldValidator:Text

Any text of your choice to display when a value is not entered into the field.

CausesValidation

Specifies whether the data input on the page should be validated.

Columns

Specifies the screen width, in characters, of a text box.

Note: Use the MaxLength pass-through attribute to specify how many characters can be entered into the text box control.  For large fields, Columns typically will be less than MaxLength.

CssClass

This pass-through attribute is generated by the Application Wizard and not set directly.  It is generally set to “field_input”.

EnableViewState

Specifies whether View State information is saved by the application.

MaxLength

Specifies the maximum number of characters (maximum length) that can be entered in a single line text box control.  Note: MaxLength works only for single-line and password text boxes; it does not work when TextMode is ‘Multiline’.

RepeatColumn

Specifies the number of columns to display when a radio button list is selected.  The number of rows displayed depends on the number of values in the underlying data being displayed.  Use the RepeatColumns pass-through attribute in conjunction with the RepeatDirection.

RepeatDirection

Specifies the layout for a radio button list.  The number of rows and columns displayed depends on the number of values in the underlying data being displayed.

RepeatLayout

You can also use the cellpadding and cellspacing pass-through attributes to increase or decrease the spacing between the radio button list columns.

Rows

Specifies the number of rows when multi-line text box is selected via the TextMode pass-through attribute.

TabIndex

Specifies the numeric sequence order for tabbing between fields.  ‘1’ is the first field displayed, ‘2’ is the second, and so on.  You can set any numeric number you wish to assign to the TabIndex property for any control.  In this way, you can define the TabIndex property for all fields in a record control or table control.

Text

Specifies the initial text (initial value) displayed in the field.

TextMode

Specifies whether a password or multi-line text box control is generated.

If you wish a single line text box to be displayed – the most common case – then omit the TextMode pass-through attribute.  The default is a single-line text box when the TextMode pass-through attribute is not set.

Visible

Width

Sets the width of the .NET control.

Note: Please be sure to rebuild the application after adding the pass-through attribute.  The updated page and code won't be generated unless you rebuild.

<Tag Name>FvDsHyperLink:Visible

The calendar date selector control is enabled by default if this pass-through attribute is not present.

Example:

            OrderDateFvDsHyperLink:Visible