Please enable JavaScript to view this site.

Navigation: Using ASPRunner.NET

Miscellaneous settings

Scroll Prev Next More

Miscellaneous settings screen

The Miscellaneous settings screen allows setting Project, Table specific, and Enterprise Edition settings.


Project settings

The Project settings block includes settings that affect the entire project.


Use the Language dropdown box to set the project language. By clicking the Multiple languages button, you can select several project languages and give users the ability to select the language when logging in. The translation of standard buttons and elements is already included in the ASPRunner.NET, so you don't need to translate them yourself.



This is how the dropdown list option looks like in the generated project.


Regional settings

Choose the country from the dropdown box to select its regional settings. These settings affect the year-month-day order, the first day of the week, etc.

Output code page

This dropdown allows selecting the character encoding for the project.

Label Editor

Label Editor allows you to:


edit table and field labels (Table labels tab);

edit custom labels (Custom labels tab);

add tooltips to the Edit forms (Edit form tooltips tab);

edit web page titles (Page titles tab);

edit the project logo (Project Logo tab);

setting the placeholders for the fields (Input placeholders tab);

editing the EU cookie consent banner text (EU cookie banner tab).


You can translate labels into several languages. Click Choose languages to add more languages to the project.


You can export multilanguage labels to a CSV file (use the Export to CSV button), then edit the labels in the external editor and import the file back (use Import from CSV button).


Note: if you use languages other than English in the project, we recommend editing the CSV files using Google Docs or OpenOffice.

Due to the problems with the character encoding, we do not recommend using Microsoft Excel for projects with multiple languages.


Table labels


Modify and translate the table and field labels to make them more user-friendly. Filter the labels by table or field to limit the data displayed. Use <br> to insert a line break in the field label.



Custom labels


Use the Custom labels to translate error messages in regular expressions and custom validation plugins. You can also create custom labels to display messages to a user. Filter the labels by the Label Id to limit the data displayed.



If you have created Custom labels and want to place the language-dependent text on a page, you can add a C#/VB.NET code snippet to the page and use the following code in it:




Replace "CustomLabelID" with the correct custom label identifier.



Edit form tooltips


Add a tooltip to a field to display additional information about it on the Add/Edit page, or during inline editing on the List page. To create a multiline tooltip, use <br> as a line separator.



Here is how it looks in the browser:



Page titles


To edit a web page title, deselect the Default checkbox next to it and make the changes. Filter the page titles by the table or page to limit the data displayed.



While editing the page title, you can use the field values, e.g. {%ID} and {%Make} for View and Edit pages. For example:


Cars, Edit record [ID:{%ID}]
Customers, {%FirstName} {%LastName}


You can also use the field values of the master table on the List page of the details table. Here is the example of a page title for the Order details table:


Orders, ID: {%master.OrderID}



Project logo


Change the project logo with the Project logo tab. You can enter plain text or HTML code here.


Here is an example of the code that can be used to display a logo icon and text:


    <IMG id="navbarlogo" alt="Project logo" src="">
     Cars Project


That's how it looks like on the generated page:


You can do even more by using the Labels/Titles API function setProjectLogo. You may, for example, add the logo image and the current year to the project logo.

Put the logo.png into the images folder of your application, and add the following code to AfterAppInit event:


Labels.setProjectLogo("<DIV style='position: relative; height: 40px; top: -6px; white-space: nowrap;'><IMG height='80%' id='navbarlogo' alt='Project logo' src=''> Cars project - "+DateTime.Now.Year.ToString()+"</DIV>");


Input placeholders


The placeholder specifies a short hint that describes the expected value of an input field (e.g., a sample value or a short description of the expected format). Placeholders are displayed in the input field before the user enters a value.



Here is how it looks like in the browser:



Check this Live Demo for more information.


EU cookie banner


This tab sets the text for the EU cookie consent banner option. You can use <br> as a line separator.


Email settings

With Email settings, you can enter the email from which to send emails to the users, and define the settings of the custom mail server, if you do not use the built-in mail server. The Two-factor authentication must be turned off to send emails.



To send emails via Gmail, use the following settings:


SMTP server:

SMTP server port: 465

Secure connection: SSL

SMTP username: <your gmail address>

SMTP password: <Gmail password>


A few more Gmail-specific notes:


Logon to your Gmail account at least once before using Gmail's SMTP settings in your project

Turn off two-factor authentication

Allow "Less secure apps" in Gmail account settings


Note: SMTP server, SMTP server port, as well as Secure connection (SSL) settings, may differ from the ones stated in the example. Contact your Mail Service Provider to get the necessary information.

SMS settings


The SMS Settings option lets you use your Twilio account to send the SMS to users. SMS are required to set up the Two-factor authentication.


You can open a Twilio account here:

Note: Twilio is not free. Their rates depend on the number of messages you send among many other things.


Multiple SMS providers


ASPRunner.NET supports several SMS providers, you can choose the most suitable one.


List of the providers: (default)


Here is a step-by-step instruction on how to use these providers:


1) Proceed to the "smsapi" folder. You can find it in your installation folder (\source\include\smsapi).


2) Copy an SMS provider file, e.g., "messagebird.cs", from that folder and replace the existing sms.cs file with it. The path to the SMS file is source\include\sms.cs.


3) Create an account on the website of the chosen provider.


4) Insert your credentials into the new SMS provider file.


After you do these steps, the messages will go through the selected SMS provider. It is used in the Two-factor authentication mechanism, and also, each time the Runner_sms function function is invoked.

Landing page

Select the application page to open after the Login page, or when the user enters the site, if the login is disabled or a guest user login is enabled. Alternatively, you can enter a custom URL, for example, a URL with search options carscars/list?qs=audi




Map settings

Select the map provider and enter the API Key (if required). You can get Bing maps API key for development purposes for free at


To learn more about inserting maps and working with them, see Insert Map. Most mapping providers require you to specify an API key for the mapping functionality to work. Here is the link that explains how to create an API key for Google Maps. Other mapping providers have a similar option in the control panel.

Error reporting

You can select Show detailed error messages to display detailed error messages or deselect it and type in the custom error message. You can also translate the custom error message into all of the languages of the project.


Add Chinese, Japanese, and Korean language support to PDF

Select this checkbox if you have selected any of the languages above as project languages and you use PDF-related options in your project.

EU cookie consent banner

Select the EU cookie consent banner checkbox to enable the customizable banner which appears at the bottom of the page. To edit the text, click the Message button, and enter the text into the EU cookie banner tab of the Label Editor.


Here is how the banner looks like in the browser:


Section 508 compatibility

Select this checkbox to make the project accessible to a wide range of people with disabilities. For more information, visit


Additionally, there are keyboard hotkeys available as described below:


ALT+E - inline edit current record;

ALT+S - save current record;

ALT+C - cancel inline edit;

ALT+F - go to the advanced search;

ALT+M - jump to the menu;

CTRL+left arrow - previous page;

CTRL+right arrow - next page.


You can also use the keyboard to navigate through the table links on the List page. Press Arrow Up, Arrow Down, Tab, Shift+Tab to switch between the elements.


When using special internet browser readers, the hotkeys reference link becomes available.

Table specific settings

The Table specific settings are miscellaneous settings that can vary from table to table. Use the Tables list on the left-side panel to switch between tables.


Warn about leaving Add/Edit pages

This checkbox allows displaying a warning message upon leaving the Add/Edit pages with unsaved changes.


If you need to skip this warning programmatically add the following code to one of Javascript events:



Display "Loading..." box on the list page

This checkbox allows displaying a loading icon until the page loads completely. Use this option if you have large size images or other elements on the page.

Next/Prev buttons on Edit/View pages

This checkbox allows displaying the Next/Prev buttons on the Edit/View pages. These buttons allow switching between records without going back to the List page.


Note: for this option to work correctly, you must choose the key field for the selected table on the Choose pages screen.

Rollover row highlighting

Select this checkbox to turn on the row highlighting feature. This feature makes the mouse pointer highlight the table row on the list page.

Search and Filter settings

This button adjusting the search and filter settings. For more information, see Choose fields: Search and Filter settings.

Hide data until search

This option hides all of the records on the page and displays a message: "Nothing to see. Run some search". The user needs to run a search to display the results.

Records per page

This option sets the initial number of records to be displayed when the users load the page for the first time. If you need to show all the records initially, enter a larger enough number there like 9999.

Records per page selection

This field defines what options to show in pagination control. Type in all to enable the option to show all records.

Apply to all tables

This button applies the current Hide data until search, Records per page, and Records per page selection settings to every table in the project.

Enterprise Edition settings

These settings are available only in the Enterprise Edition of ASPRunner.NET.


Web reports

Select the Web reports checkbox to enable the online report/chart builder. Click the Administrator button to specify the password to access the Web Reports and Charts admin area.

See also:

Choose pages screen

Choose fields screen

Security screen

Page Designer

Two-factor authentication

Localizing ASPRunner.NET applications

A complete guide to sending emails with a web based application