Field Setup
After loading the database, the database objects (tables, views, custom
views and reports) will be shown in the left pane (the database pane).
Click on any database object to go to the Field Setup Page for that object
at any time.
ASP.NET Maker support all commonly used ADO data type. If ASP.NET Maker finds
an unsupported field in a table, an "Unsupported Fields" tab
will appear. You can click on the tab to view the list of fields that
are not supported.
The Field Setup pages consists of two section. The upper section is a
grid showing available options of all fields. The lower section contain
two panels, the [Edit tag] panel and the [View
tag] panel for the selected field.

The grid consists of the following sections:
General

Properties
| Field Name |
Field Name (read only) |
| Data Type |
Data Type (read only) |
| Size |
Maximum field length (read only) |
| Caption |
Caption to be displayed |
| Primary Key |
Primary Key of the table
Important Note:
- You should never change this field unless you are absolutely
sure that this field is unique. Otherwise a particular record
cannot be located and unexpected results may occur.
- From v2.0, composite key is supported, and primary key is uneditable
in the edit page.
|
|
Page |
Page number of the field.
From v3.0+, multi-page Add/Edit is supported. By default all the fields are in page
1 and multi-page is disabled. If you set any page to larger than 1, multi-page feature
will be enabled automatically.
|
Custom field display order by drag-and-drop
You can change the field order defined in the database by simple drag-and-drop.
Simply click the Field Name column to select the field, then drag it to
where you want. ASP.NET Maker will generate ASP.NET and display records
according to this order.
List Page

Properties
| List |
Show field in list page |
| Aggregate |
Enable Field Aggregation. Aggregated values will be shown at Page
Footer. Not applicable in multi-column view. Aggregate options include:
- TOTAL (sum of all field values in current page)
- COUNT (count of records in current page)
- AVERAGE (average field value in current page) |
| Width |
Specify field column width |
| Wrap |
Enable/Disable wrapping of field text |
| Quick Search |
Include this field when performing quick search.
Note: Only text fields and numeric fields are supported
in Quick Search. By default only text fields are enabled. |
|
Ext. Search |
Use this field in Extended Quick Search (ASP.NET Maker 3+)
Extended Quick Search is enhancement of Quick Search. It is sort of a combination
of Quick Search and Advanced Search. If a field is checked for Ext. Search, a form
element for the field will be shown in the Quick(Basic) Search form and the user
input criteria for this field will be included when performing Quick(Basic) Search.
Extended Quick Search will use the same search operators specified under the "Advanced
Search Page" section (see below).
|
View Page

Properties
| View |
Show field in view page |
| View Tag |
HTML tag to display the field. Used in List/View pages. |
You can either click the [View Tag] column and select a View Tag
from the drop down box or click the icon on the View Tag panel toolbar
to select. After selecting the View Tag, you can further setup its properties
in the View tag panel.

There are two types of View tag, Formatted Text and
Image.
Formatted Text - View Tag to display the field value
as formatted text with optional hyperlink. Properties:
| Style |
| Bold |
Display as Bold (enclosed with <b> </b>
tags) |
| Italic |
Display as Italic (enclosed with <i> </i>
tags) |
| Align |
Left/Center/Right/Justify. Align the data (enclosed
with <div> </div> tags) |
| Format |
| None |
No formatting |
| Currency |
Display in currency format (VBScript FormatCurrency
function) |
| Date/Time |
Display in date format (ASP.NET Maker formatdatetime function)
|
| Number |
Display in number format (VBScript FormatNumber function)
|
| Percent |
Display in percent format (VBScript FormatPercent function) |
| String |
Format the field value with specified VBScript string function or
custom function |
| Max Length (List page) |
Truncate the field value at specified max. length and append
"..." to the end.
Note: This setting only applied to memo fields
in list page and must be larger than 0 to take effect. |
| Hyperlink |
| HREF field |
Display the field as hyperlink with the href attribute set to the
value of this field. Can be the field itself. |
| Target |
_top/_parent/_self/_blank |
| Prefix |
- None (no prefix, relative path of url)
- http:// (prefix http:// added, absolute path of url)
- mailto: (prefix mailto: added, email link)
- ftp:// (prefix ftp:// added, ftp link)
- file:// (prefix file:// added, file link)
- news:// (prefix news:// added, newsgroup link) |
| Suffix |
Append the input string to the URL |
Image - View Tag to display as Image using <img>
tag. The field should be a BLOB field or a field storing the path of the
image.
| IMG Tag attributes |
| Width |
Specify the width of the image |
| Height |
Specify the height of the image |
| Hyperlink (same as above) |
Edit Page

Properties
| Edit |
Show field in edit page |
| Read Only |
Make the field read only in edit page |
| Edit Tag |
Form element for the field. Use in Add/Copy/Edit/Search pages. |
You can either click the [Edit Tag] column and select a Edit Tag
from the drop down box or click the icon on the Edit Tag panel toolbar
to select. After selecting the Edit Tag, you can further setup its properties
in the Edit Tag panel:

Edit Tags
ASP.NET Maker supports all HTML form elements:
| Text |
 |
<input type="text">
tag
Display the field as a textbox.
Size - size of the textbox
MaxLength - maximum input length of the textbox
Validation - see section below
Use Lookup Table - enable auto suggest feature by Ajax. With a
lookup table, when the user type in the textbox, a dynamic dropdown list populated
with data from the lookup table matching the user input will appear for user to
select. If the data already exists, the user can easily select without typing the
full text. If not, the user can still input as usual. To enable this feature, check
this option and enter the lookup table info in the [Lookup Table]
panel next to the [Edit Tag] panel. (See section below)
|
| Password |
 |
<input type="password">
tag
Display the field as a masked textbox.
Size - size of the textbox
MaxLength - maximum input length of the textbox
Validation - see section below
|
| Radio |
 |
<input type="radio">
tag
Display the field as an option of a radio button list. You can enter the options
manually in the [User Value] panel next to the [Edit Tag]
panel.
Use lookup table - use an existing lookup table instead of user
input value/label pairs for the radio buttons. To enable this feature, check this
option and enter the lookup table info in the [Lookup Table] panel
next to the [Edit Tag] panel. (See section below)
Repeat columns - specifies the no. of radio buttons per row
Validation - see section below
|
| Checkbox |
 |
<input type="checkbox">
tag
Display the field as one or more option(s) of a checkbox list. You can enter the
options manually in the [User Value] panel next to the [Edit
Tag] panel.
Use lookup table - use an existing lookup table instead of user
input value/label pairs for the checkboxes. To enable this feature, check this option
and enter the lookup table info in the [Lookup Table] panel next
to the [Edit Tag] panel. (See section below)
Repeat columns - specifies the no. of checkboxes per row
Validation - see section below
Note: The submitted values of the multi-selected checkboxes is a comma-separated
string. Therefore you must use a string field for checkbox list.
|
| Select |
 |
<select> tag
Display the field as a combobox (dropdown list) or a listbox. You can enter the
options manually in the [User Value] panel next to the [Edit
Tag] panel.
Size - no. of options to show. If more that 1, the
selection list is shown as a listbox, otherwise it is shown as a
combobox.
Multiple: Check to enable multiple selection (for listbox only)
Note: The submitted values of the multi-selected listbox is a comma-separated
string. Therefore you must use a string field for checkbox list.
Use lookup table - use an existing lookup table instead of user
input value/label pairs for the checkboxes. To enable this feature, check this option
and enter the lookup table info in the [Lookup Table] panel next
to the [Edit Tag] panel. (See section below)
Validation - see section below
|
| TextArea |
 |
<textarea> tag
Display the field as a textarea.
Cols - no. of columns of the textarea.
Rows - no. of rows of the textarea.
Use DHTML Editor - replace the textarea with a DHTML editor for
editing the data as HTML.
Note: The DHTML Editor(s) requires newer version of browsers such
as IE6+, NS7+ or FF1+. It is not developed by the author of ASP.NET Maker and no technical
support will be provided. (See Third-party Tools.)
Validation - see section below
|
| File |
 |
<input type="file"> tag
Display the field as a file upload control. For BLOB fields or string fields only.
Size - size of the input tag (NOT file size)
If the field is of BLOB (binary) data
type, file is uploaded to the database.
You can also store the information of the uploaded file in the following
fields:
File type field - Recommended. Useful when you
want to response to user browser the exact content type of the data.
File name field - Optional. Useful if you want
to use the original filename.
Note: Do not specify file name field if you want
IE to open the file automatically. (IE may fail to open non-image
files retrieved from database properly.) Use file name field if
you want IE to popup a File Download
dialog for
user to save the file with the filename specified in the file name field.
File size field - Optional. Stores the uploaded
file size.
Image width field - Optional. For use with images only. Stores
the width of the uploaded image.
Image height field - Optional. For use with images only. Stores
the height of the uploaded image.
If the field of string type, file is
uploaded to a subfolder relative to the application root.
Upload folder - the folder where the uploaded file will reside.
If you do not enter a specific folder, all the uploaded files will be put in the
global upload folder specified in the ASP.NET tab (see ASP.NET
Setup).
Notes:
- Make sure that the Web server user have read/write access to the folder. You can
right-click the folder in Windows Explorer and add read/write access for IUSR_<MachineName>
on the Security tab.
- The path is relative to application root. Use slashes "/" as path delimiter, no
leading slash. e.g. If the application root of your website is C:\Inetpub\wwwroot\demo
and you enter "uploads/folder1" in this textbox, the folder for the uploaded files
will be C:\Inetpub\wwwroot\demo\uploads\folder1. If you are not sure which folder
is application root, please read Creating Virtual Directories
in IIS.
Validation - see section below
|
| Hidden |
 |
<input type="hidden"> tag
Hide the field with a hidden form element.
Note: This is different from de-selecting the field in the
[Edit] column. If a field is de-selected, no code will be generated
for the field in the Edit page and the field will not be updated. With a hidden
form element the field is not seen but it may still get updated.
Custom value - by default the 'value' attribute contains the field value, custom
value is used to update the field with an other value, for example,
Date(), when a record is updated using the edit page.
Notes:
- Custom value is used in Edit page only. It cannot be used with Read-only
fields, User ID fields and Detail fields(Foreign key fields)
- In Add page, if a default value is specified (see section below), hidden form element
will also be used but the 'value' attribute will contain the default value. If default
value is not specified, the field will be displayed as a normal textbox.
|
Using User Values for Edit Tag (Radio/Checkbox/Select)
For Radio/Checkbox/Select Edit Tags, the default option
values are user input values, you can enter as many value/label pairs
as you want in the [User Values] panel next to the [Edit
Tag] panel.
Using Lookup Table for Edit Tag (Radio/Checkbox/Select)
In real world applications, the option values usually come from a (lookup)
table in the database. ASP.NET Maker make it very simple to use lookup values
for key field values, simple click [Use Table], the [Lookup
Table] panel will replace the [User Values]
panel, select the following properties:

| Table name |
The table to be linked to |
| Link field |
The field to be used as the value of an option (for Radio/Checkbox/Select only).
This field is usually the primary key of the lookup table.
|
| Display field #1 |
The field in lookup table to be used as the label of an option. (If auto suggest
textbox, only string fields will be selectable.)
|
| Display field #2 |
Optional. Another field in lookup table to be included in the label of an option.
(If auto suggest textbox, only string fields will be selectable.)
|
| Order By |
Optional. Used to sort the options |
| Asc/Desc |
Optional. Sorting order. |
| Distinct |
Optional. Unique records only. (for Radio/Checkbox/Select only) |
| Filter |
WHERE clause to filter options from the table |
|
Parent combobox |
Optional. For used with the Dynamic Selection List feature. Available for <select>
tag only. Specify the parent combobox of this combobox. When the parent combobox
changes, the available options in this combobox will be changed accordingly.
Note: Dynamic Selection List does not support multiple selection. |
| Filter Field |
Optional. For used with the Dynamic Selection List feature. Available
for <select> tag only. If this <select> tag is setup as
the Second Combobox (see below), the options in this <select>
tag will be changed with the selected option of the first combobox.
It is done by filtering the linked table records by this field. Only
records with a Filter Field value matching the selected value of the
first combobox will be shown.
Note: Dynamic Selection List does not support multiple selection. |
| Allow Add |
Optional. If enabled, the user will be allowed to add an option to the selection
list.
Notes:
- Review your lookup table design before using this option. The option works best
if you there is only one display field and the link field (primary key) is an autoincrement
field. In that case the user only need to fill in a textbox and the option is added.
But if the link field (primary key) is not an auto-increment field, the user will
need to enter the link field value which the user may not know.
- The user will be asked to enter the link field and the display field(s) only. If
the lookup table has other NOT NULL fields other than the link field and display
field(s), the new option cannot be added. However, you can define default values
for these fields in the database (not in ASP.NET Maker).
- Currently this feature is supported in Add/Edit page only, it is not available in Inline-Edit.
- This feature is implemented using Ajax, IE6+/NS7+/FF1+ is required.
|
JavaScript Validation (for add/copy/edit/search pages)
The data input for each field can be validated using client-side JavaScript.
| Validate |
Supported data type are:
Integer, Float, Range, Date(yyyy/mm/dd), Date(mm/dd/yyyy), Date(dd/mm/yyyy),
Time(hh:mm:ss), Email, Credit card, GUID, US phone numner, US zip
code, US social security number
Note: Other than "/", the date separator
of the validation format can also be "-" or ".",
depending on the default date format setting in ASP.NET
Settings page. |
| Use popup calendar |
If Validate is one of the date formats, check
this option to use a visual date picker instead of manual input.
Note: The popup calendar is not developed by the author of ASP.NET Maker and no technical support
will be provided. (See Third-party Tools.) |
| Required |
Check this checkbox if the field is mandatory |
| Error Message |
Enter the error message to popup if error occurs |
|
Check Duplicate |
Specify whether to check duplicated values for the field.
If the field is an unique indexed field, ASP.NET Maker will generate server side codes
to check duplicate values automatically even this option is not selected. This option
is useful when you want to check a non unique indexed fields for duplicated values
in the Add page.
Notes: The validation is done on server side in Add page only.
|
Add Page

Properties
| Add |
Show field in add page |
| Default Value |
Default value for field (for adding new record only) . Must be
a valid VB.NET / C# expression. (If it is a string, must be double
quoted.) |
Advanced Search Page

Properties
| Search |
Show field in Advanced Search page (Note: NOT related to Quick
Search) |
| Search Opr 1 |
Search operator #1 for the field. Used in Advanced Search or Extended Quick Search. |
| Search Opr 2 |
Search operator #2 for the field. Used in Advanced Search or Extended Quick Search.
Notes:
- This second search operators will be useful when you may have 2 criteria for the
field when searching. You can also select AND/OR to relate the 2 criteria.
- ASP.NET Maker (3+) supports "BETWEEN" search operator. If you want to use it, select
"BETWEEN" in the first search operator. When "BETWEEN" is used, the 2 search criteria
will be used up and the second search operator will be ignored.
|
|