Web Application Generator

The Advanced Search Bar automatically determines multiple search options for each search field, based on the type of the field.

It is possible to limit the amount of options displayed to the user.

Let’s require users to search by the Birth Date field on the Employees grid view, and only permit between, equals, and includes search options.

Start the Project Designer. In the Project Explorer, switch to Controllers tab, and double-click on Employees / Views / grid1 / BirthDate data field node.

Make the following changes:

$between,=,$in

Press OK to save the data field. On the toolbar, click Browse to regenerate the web application.

Navigate to the Employees page, and expand the advanced search bar.

The Birth Date search field will appear first, with a limited subset of search options. The first search option will be activated when the search bar is opened for the first time.

For the Last Name field, instead of having the default first search option of equals, let’s change it to begins with, and preserve the rest of the search options.

Go back to the Project Designer. In the Project Explorer, double-click on Employees / Views / grid1 / LastName data field node.

Make the following changes:

$beginswith,*

Press OK to save the data field, and click Browse on the toolbar.

Activate the search bar on the Employees page, and you will see that Last Name shows up by default. The begins with search option will show up first, but the user can change it to any other option.

If you would like to use a standard or third-party ASP.NET components on your pages, then a custom user control should be created and inserted in the page. Let’s add a few custom user controls and a data view to a test page.

Creating the Page

Start the Project Designer. On the action bar, click New | New Page option.

Give this page the following properties:

Press OK to save the page.

Adding Containers

In the Project Explorer, right click on Test page node, and select New Container.

Enter the following properties:

Press OK to save the container. Create three more containers, configured as follows:

Creating and Adding the User Controls

In the Project Explorer, right-click on Test / c100 container node, and select New Control.

Next to the User Control property, click on the New User Control icon.

Give this user control the following properties:

Press OK to create the user control and have it selected in the User Control property.

Press OK again to save the control.

Right-click on Test / c101 container node, and choose New Control. Click on the New Record icon again, and create a new user control:

Press OK to save the user control, and again to save the control. Create another control on Test / c102 container node. The new user control will have the following parameter:

Save the user control and control, and create another control on Test / c103 container node. The user control will use the following:

Save the user control, and then the control. The logical page structure in the Project Explorer should look like the picture below.

Exit the designer, and generate the web application.

When your default web browser opens the app, navigate to the Test page. There will be four user controls on the page, in two rows.

Customizing the User Controls

Switch back to the web application generator, click on the project name, and select Develop to open the project in Visual Studio. In the Solution Explorer, double-click 0n ~\Controls\TopLeft.ascx file.

Press Ctrl+K, Ctrl+D to format the document. Add the highlighed CSS rule to the style attribute of the div element:

<%@ Control Language="C#" AutoEventWireup="true" CodeFile="TopLeft.ascx.cs" 
    Inherits="Controls_TopLeft" %>
<asp:UpdatePanel ID="UpdatePanel1" runat="server">
    <ContentTemplate>
        <div style="margin: 2px; border: solid 1px silver; padding: 8px; 
            background-color:LightBlue; height: 150px;">
            uc:TopLeft</div>
    </ContentTemplate>
</asp:UpdatePanel>

Save the file. In the Solution Explorer, double-click on ~\Controls\TopCenter.ascx file.

Format the document using Ctrl+K, Ctrl+D, and enter the following CSS properties in the style attribute of the div element:

background-color: LightGreen; height: 150px;

Save the file. In the Solution Explorer, double-click on ~\Controls\TopRight.ascx file.

Format the document, and enter the following CSS properties in the style attribute of the div element:

background-color: Pink; height: 120px;

Save the file. Switch back to the web browser and refresh the page. The three top user controls will have the assigned background colors and height.

Adding a Data View

Switch back to Visual Studio. In the Solution Explorer, double-click on ~\Controls\CustomerList.ascx document,

Press Ctrl+K, Ctrl+D to format. Making sure to preserve the original <%@Control%>  header, replace the UpdatePanel element in the file with the following:

<asp:UpdatePanel ID="UpdatePanel1" runat="server">
    <ContentTemplate>
        <div id="Customers" runat="server">
        </div>
        <aquarium:DataViewExtender ID="dve1" runat="server" 
        Controller="Customers" TargetControlID="Customers"
            PageSize="5" ShowInSummary="true" ShowPager="false"/>
    </ContentTemplate>
</asp:UpdatePanel>

Save the file, and refresh the webpage. The customers list will load underneath the three colorful user controls.

Changing the Page Layout

Switch back to the Project Designer. In the Project Explorer, expand the Test page. Move the c103 container to the first position.

On the toolbar, press Browse. Navigate to the Test page, and you will see that the customers list will be at the top of the page, with the colorful user controls underneath.