Placing ASP.NET Directives in Application Pages

Go to:

Right-Click, Page Directives…

You can place ASP.NET directives in pages via the Page Directives dialog (Right-click, Page Directives…), either globally for all your application’s pages by placing them in your application’s master pages or in an individual page.

@Register directives can occur anywhere in your page as long as they are placed before the first use of a tag prefix:

For example, you may have an existing web page header and footer, which were developed using Visual Studio .NET as web user controls.  By way of example, insert the following into the Page Prologue (Right-click, Page Directives…):

<%@ Register TagPrefix="MyControl" TagName="Header" Src="/MyApp/Shared/Header.ascx" %>


<%@ Register TagPrefix="MyControl TagName="Footer" Src="/MyApp/Shared/Footer.ascx" %>

Where the header to be inserted is:





and the footer to be inserted is:





Register directives and code generation tags

The TagName for all ASCX Register directives is based on the Name of the ASCX component/class (e.g. Button), and not the name attribute of the GEN:Use tag (e.g. OKButton).  The name attribute of a GEN:Use tag is used to derive the ID attribute of the ASP.NET server control tag that will replace the GEN:Use tag, but not the directive and not the TagPrefix or TagName of the server control tag.

Several caveats apply:

Registering custom controls created with Iron Speed Designer

You don’t have to register any controls created by Iron Speed Designer in pages also created by Iron Speed Designer; Iron Speed Designer does this for you automatically.  However, you may wish to use custom controls created by Iron Speed Designer on pages that were not created by Iron Speed Designer, such as hand-created pages on your website or another application not created by Iron Speed Designer.

To use controls created by Iron Speed Designer in other web pages, you must register them properly on those ASPX web pages.  Here is an example of a control registration directive:

<%@ Register Tagprefix="MyApp4" TagName="Button" Src="../Shared/Button.ascx" %>

This is how the control should be used within the ASPX page.

<MyApp4:Button runat="server" id="OrdersSearchButton" Button-CausesValidation="False" Button-CommandName="Search" Button-Consumers="OrdersSearchArea" Button-Text="Go">


Example: Automatically Refresh Page on Periodic Basis

Example: Adding Application-Wide HTML Tags via Master Pages

See Also

Customizing Web Page Layout

Navigating Your Application in Layout Editor

Using the Page Layout Spreadsheet and Toolbox

Customizing Page Contents with the Cell Editor

Configuring Cell, Row and Table Styles

Configuring Master Pages

Placing ASP.NET Directives in Application Pages

Using Frames in Application Pages