Show/Hide Toolbars

Navigation: Using ASPRunnerPro

ASPrunnerPro32x32     ASPRunnerPro manual

Working with projects

Scroll Prev Next More


Click Project button and select one of the option from the drop down list to create new project, open or save an existing one, define project settings.


Creating new project

To create new project, click Project button and select New Project. When you create a new project you have two options:

Create a new project from scratch by selecting Blank application.


Create a project from the template.


For more information about templates that are shipped with ASPRunnerPro, see What are templates.

Project structure

With ASPRunnerPro, you can save all your settings in a single project file and do not have to go through individual files if you simply need to change a single label or field format.


For each project ASPRunnerPro saves to its own directory with the following subdirectories:

1.visual - Contains modified visual templates.


2.tmp - Temporary storage of visual templates and other files. tmp\backup directory stores backup copies of your project. Project backup name (i.e. Project4.2011-11-09 contains date and time of when backup was created.


3.output - Directory with output files. You can point output directory to another folder on Output directory screen.


4.source - contains additional files to be included in the build process.


5.styles - contains project styles and color schemes


The default directory for a new project is C:\Users\<username>\Documents\ASPRunnerProProjects\project_name. The Project file will be saved in the project directory as project_name.aspr.


When you open a project created with ASPRunnerPro 5.x or older, you are prompted to choose a project directory. After you select a directory, your project file is copied to it. Then the next time you open your project it will be from the folder you selected, not from the original location.


If you upload files to the Web server using third party FTP client software, you must upload the entire contents of the output directory.


When you make a backup of your project, you should include all files in the project directory together with all subdirectories. At a minimum, you should backup the project file itself along with all files in the visual directory.


Click Project button and select from the drop down list to open an existing project or to save the current one.

Opening an existing project

To open existing project, select Open project.

Saving a project

If you want to save the current project under a different name - for example, development purposes or to create a backup - select Save Project As option. A new project directory will be created and all necessary project files will be copied to it.


yellowbulbNote: ASPRunnerPro creates a new project automatically upon startup.

Saving your project as a Template

You can save your project as a template.Visual


In this case, your database along with your project file and all files you have edited with the Visual Editor will be saved.


yellowbulbNote: Save Project As Template option is available only in MySQL, SQL Server and MS Access projects.


While saving Project As Template you need to type in the template name you wish your project to be saved under. The template will be saved in the Business Templates Directory (by default in C:\Users\<username>\Documents\ASPRunnerProTemplates\project_name).


yellowbulbNote: After your template is saved, you can add files that are not generated by ASPRunnerPro to the template directory.



After that saved Template will be available on the list of templates when you create a new project.


You can also add a thumbnail image to the template that will be displayed on templates list. Place an image named preview.gif (JPG and PNG formats are supported also) to template folder. Image size should be 130x97.

Add template to the project

You can create new project using two templates or add a template to existing project. To avoid replacing template tables with existing all ASPRunnerPro business templates (tables and files) have prefix.



If you have added several templates to the project you can choose one to inherit security settings from in Security template dropdown box.


If you add more than one template to the project you can get some errors trying to run your project right after that. This what you need to do in order to add two or more templates to the same project.


1. Create a temporary test project using second template


2. Proceed to AfterAppInit event and copy all code there. Close temporary project without saving.


3. Go to your original project and paste this code to the end of AfterAppInit event.

Project settings



Use Create human-readable labels for the database fields option to convert field names into the more human readable format. For example, if this option is enabled, the field name id will be displayed as Id, last_name as Last Name, FirstName as First Name etc.


Use Synchronize the database on each project load option to enable/disable automatic database synchronization. We recommend to use this option for small or local databases. For more information about database synchronization, see Datasource tables: Synchronize database.

To increase or decrease the files upload speed, change the number of FTP upload connections.


Enable Autocomplete option enables Intellisense that provides autocomplete popups and function calltips in Event Editor.


Exclude system tables option excludes system tables from the list of tables for Users table, Lookup tables etc.


Use Always add database wrappers option to add wrappers to all names of fields and tables. When this option is disabled, database wrappers will be added only to the field names containing spaces and service field names.


After you enabled Lock pages modified in Visual Editor automatically option, all pages that you manually modify will be locked from further automatic modifications. You can still modify locked pages manually.


Use Format HTML code option to auto-format HTML code of pages in Editor.