Step 1: Name Your Application

 

Use the Application Wizard to create new applications.

The first step in creating a new application is to give it a name and a directory location for its files.  Additionally, several advanced settings are available, allowing you to select the “culture” for your application, which determines the various localization feature settings.

Field

Description

Application Name

The name of your application is used for identification purposes and as a prefix in certain parts of your application, including:

  • A prefix for the generated database stored procedures.

  • A tag prefix (i.e. namespace) for server controls tags in the generated ASPX and ASCX files.

Please note that if you pick any of these application names:

  • ASP

  • IronSpeed

then the prefix will be changed to App<NAME>.  This prevents a name collision with ASP and IronSpeed presentation-level control tags.

Names must start with a letter and can contain letters and numbers (alphanumeric strings).

Note: You cannot change your application’s name after the application has been created.  Changing the application name would require Iron Speed Designer to regenerate all of your web pages and source code files (because the name space defaults to the application name), which is difficult to do without breaking customizations you might have made to the page and source code files.

Application Namespace

The name space is used when generating the Presentation Layer and Data Access Layer code.  It generally is the same as the Application Name, though there is no requirement that this be the case.

Name space restrictions:

The name space should not contain non-ASCII characters, such as European or Asian characters.

Note: You cannot change your application’s name space after the application has been created.  Changing the application name space would require Iron Speed Designer to regenerate all of your web pages and source code files (because the name space defaults to the application name), which is difficult to do without breaking customizations you might have made to the page and source code files.

Application Folder

The folder location where you wish to place your application’s files.

Please note: it is possible to accidentally overwrite the virtual directories used by Microsoft IIS, so use caution when selecting a folder name.

IISAdmin

IISHelp

IISSamples

Code language

Select the programming language for code generated by Iron Speed Designer.

Note: You can change your application’s code language after it has been created.  However, any modifications you make to the generated source code files will not be migrated to the newly generated application; you must port any code customizations by hand after switching code languages.

Compiler

Specifies the compiler with which you wish Iron Speed Designer to compile your applications.

Visual Studio 2003
(devenv.exe)

Compile your application using Visual Studio .NET 2003.

Note: Visual Basic .NET and Visual Basic 6.0 are very different products.  Visual Basic .NET is object oriented, and supports Microsoft's .NET platform.  Iron Speed Designer generates Visual Basic .NET code, and does not generate Visual Basic 6.0 code.

Visual Studio 2002
(devenv.exe)

Compile your application using Visual Studio .NET 2002.  Please be sure to install Service Pack 1 or later; Earlier releases of Visual Studio 2002 have bugs which cause certain legal code constructs to not compile.

csc.exe (C#)

CSC is command line-driven compiler supplied with the .NET Framework.  You do not need to acquire this compiler separately.

vbc.exe
(Visual Basic)

VBC is a command line-driven compiler supplied with the .NET Framework.  You do not need to acquire this compiler separately.

Formatting

The culture encoding for your application.  The culture encoding attributes in your Web.config file determine many aspects of your generated .NET application, including currency, date, and number format.  Your application uses these settings at run-time to determine proper operation.

The culture encoding also determines which text string resource file is used when generating your application, and is used when localizing your application.

Iron Speed provides standard English language string resource files.  As a courtesy to developers, resource files for other languages from third-party providers may be included with Iron Speed Designer.  While Iron Speed doesn’t provide support for these additional language files, we hope you’ll find them useful if your particular language is among those provided.

Messages

The Messages value determines how the resources are loaded for an application and is used for culture-specific lookup of resource data.  The only purpose of the Message value is to indicate the language the resources should load, that is, determine which language the UI strings should use.  The Formatting value determines everything else — date formatting, number formatting, and so on.

The text strings themselves are located in a resource file created by Iron Speed Designer for your application.  Complete details on how to modify the resource text strings is in “Error and Validation Message Strings” section of the “Localizing (Internationalizing” Your Application”.

Iron Speed provides standard English language string resource files.  As a courtesy to developers, resource files for other languages from third-party providers may be included with Iron Speed Designer.  While Iron Speed doesn’t provide support for these additional language files, we hope you’ll find them useful if your particular language is among those provided.

Text direction

Depending on the direction  you select, Iron Speed Designer automatically switches the text direction displayed in pages created in Iron Speed Designer.  This change is applied to pages using the page style designated in the Page Style step of Application Wizard.

Virtual directory name

You can specify the virtual directory name for your application.  By default it is the same as your application name, but you can change it at any time, even after creating the application.  If you change it after a virtual directory has already been created for the application, a new virtual directory will be created when running the application.

See Also

Creating Your First Application