Generate Settings

 

Template file Template archive (zip file)
Project folder

The project folder where the ASP.NET scripts are to be generated.

Notes

  1. Use alphanumerical characters only for the project folder name,
  2. Make sure you have write permission to this folder,
  3. This folder is NOT the wwwroot of the website, a subfolder named wwwroot will be generated under this folder, see Web root.
  4. This folder is NOT the final website. During development, you can use Kestrel web server (see below) to test the project. After development, you need to publish (see below) the project to another folder and then deploy the output folders.
Lowercase output file name Specify whether output file names are in lowercase
Start page

Specify the first page that the default page should redirect users to.

If this setting is left blank, user will be redirected to the List page of the default table (see Table Setup) or the first table that the user have permission to access.

If this setting is not blank, the default page will simply redirect user to the page you specify, e.g. a page not generated by the current project. If you start the site by the typical default.cshtml, leave this setting blank, do NOT enter default.cshtml or there will be a indefinite loop.

Clear project folder first

Delete all previously generated files in the project folder.

For example, if you have removed a table, the previously generated scripts for the removed table still exist in the project folder, you should remove them so that the newly generated project can be compiled without errors.

Publish

Specify if the project should be published after generation.

Notes

  1. No need to publish during development, you can test with Kestrel (see below) or Visual Studio. You only need to publish after finishing development and when you want to deploy the project to IIS.
  2. By default the publish folder is <ProjectFolder>\bin\<configuration>\<framework>\<runtime>\publish, e.g. <ProjectFolder>\bin\Debug\net452\win10-x86\publish under which you should many files, including a web.config file and subfolder named wwwroot, you must deploy all subfolder and files under this publish folder to the target folder of your IIS server and set the application at the target (NOT wwwroot) folder containing the web.config, read Publishing to IIS.
  3. A batch file name build.bat will be generated in the project folder, if you have modified the generated files with your editor, you can open a command prompt and run the batch file to re-publish the project without using ASP.NET Maker.
  4. There are a few advanced settings for publishing, see Advanced Settings.
Testing web server

Specify the web server that you want to use to test the generated site. For use with Browse after generation (see below). You can choose Kestrel or Other web server.

If you choose Kestrel, the generated site will be run by .NET Core. The default port number is 5000, if you want to change, set the Advanced Setting "Kestrel port number".

If you choose Other web server (i.e. IIS), you need to specify Testing root URL (see below) also.

Note If you use local IIS to test, make sure you have also installed .NET Core (Server Hosting), see System Requirements.

If you want to use Visual Studio to open the generated project, this setting can be ignored.

Browse after generation

Specify whether to open a browser to test the generated site after script generation.

If you want to use Visual Studio to open the generated project, there is no need to enable this option.

Testing root URL

Specify the URL of your testing site that maps to the publish folder. For use with Browse after generation. If you use Kestrel, this setting is NOT required.

For example, if you have set up project folder as:

C:\Users\<user>\Documents\ASPNETMaker\WebSites\Project1\

By default the publish output folder will be:

C:\Users\<user>\Documents\ASPNETMaker\WebSites\Project1\bin\Debug\net452\win10-x86\publish

Deploy the subfolders and files to the target folder of your IIS server. Use IIS Manager to setup ASP.NET application at the target folder.

Note If you use local IIS to test, although it is possible to set up ASP.NET application at the publish folder directly, you may need to stop the website when you re-generate scripts so that the old scripts can be overwritten.

If you have setup your testing website in IIS Manager so that you browse the site by URL, e.g. http://localhost:5001/

Then the Testing root URL should also be set as:

http://localhost:5001/

 

After setting above, click the [Generate] button to generate scripts. ASP.NET Maker allows you select scripts to generate, just select the files you want to generate in the [Output] column. If you want use ASP.NET Maker scripts in your custom ASP.NET scripts, you may not want to generate header and footer in those pages. Then you can enable [No header/footer] for those pages. Note that header includes the menu and the project title.

After selection, click the [Generate] button to generate scripts.

Notes

  1. If it is your first generation for the project or you have changed some project level settings, you must select [Other files] to generate the non table-specific pages.
  2. If you have opened your project in Visual Studio, close the project before re-generation so the files can be overwritten.
  3. If you are running the application with .NET Core CLI, shut it down before re-generation, then use .NET Core CLI to build and run it again.
  4. If you run the project with .NET Core CLI, and you re-generate some of the .cs scripts during development, you can use dotnet-watch (see Advanced Settings) to run the application so that it will be re-started automatically when changes in the source code are detected.

If you modify settings for a table and want to re-generate script for that table only, you can click [Unselect All], then select the files you want to re-generate and click the [Generate] button to generate again. If you are not sure which files to re-generate, click [Select All] and re-generate all files.

You can also right-click the column header of [Output] or [No header/footer] to quickly select all or unselect all items in the column.

If you need to abort script generation in the middle of the process, just click the [Cancel] button under the progress bar that displayed during generation.

 

 

 

 

Also See:

Customizing Template
Project File

 

 ©2004-2017 e.World Technology Ltd. All rights reserved.