Telerik Extensions for ASP.NET MVC

This help topic shows how to create or configure an ASP.NET MVC application which is using Telerik Extensions for ASP.NET MVC

New Project Wizard

The New Project wizard is used for creation of a new MVC application which uses Telerik Extensions for ASP.NET MVC (Telerik menu -> MVC UI Extensions -> Create New Telerik Project). The wizard consists of two steps. On the first page the user can specify some project-wide settings while on the second page he can configure the master page.

MVC Project Settings

New Project 1
Using the controls in the MVC Project Settings page you can modify various project-wide settings:
  • Version - Choose which version of Telerik Extensions for ASP.NET MVC to use
  • Add Test Project - Include a test project or not
  • Copy GlobalResources - Copy the localization files to ~/App_GlobalResources or not
  • Copy Editor Templates - Copy the predefined editor templates to ~/Views/Shared/EditorTemplates or not
  • Use CDN Support - Enable or disable CDN support.

Master Page Settings

New Project 1.5
Using the controls in the Master Page Settings page you can modify the initial behavior of the master page:
  • Skin - Choose which of the predefined Telerik UI element skins to use
  • Combine/Compress StyleSheets - Combine or compress stylesheets (register the asset.axd HTTP handler in web.config)
  • Combine/Compress Scripts - Combine or compress JavaScript (register the asset.axd HTTP handler in web.config)
  • Use Embedded jQuery - Automatically include jQuery or not
  • Enable globalization - Enable or disable globalization or not
  • Render Right-To-Left - Enable right-to-left rendering or not

Data Access Settings

New Project 2

On the next step the New Project wizard’s Data Access page offers you initialize the creation of your data access layer using Telerik OpenAccess ORM. You are given the following options:

  • Create OpenAccess Fluent Library Project

    After you choose this option an OpenAccess ORM project will be added, enabling you to create your object mapping in a declarative way. With this Code-Only approach all the necessary persistent classes and mappings are defined manually – the project will initially contain only a sample declaration to get you started. You can find more information about the Fluent Library project type here.

  • Create OpenAccess Domain Model Library Project

    The Domain Model is an auto-generated and editable diagram of your persistent classes. This option will start the Add Domain Model wizard after exiting Project Configuration Wizard, so that you can configure your data layer without writing a single line of code. You can create a new model and define you classes later using the tools that OpenAccess Visual Designer is offering, or retrieve the schema of an already designed database and generate classes for the selected tables and views. The different scenarios are described in the articles below:

    Create an empty model – Model First

    Generate the domain model from a database - Database First

  • Skip creating an OpenAccess Model Library Project

    No data access project will be added.

Project Configuration Wizard

The Project Configuration Wizard starts when the user configures a Telerik MVC Application (Telerik menu -> MVC UI Extensions -> Configure Project).

The Project Configuration Wizard consists of two pages. On the first page the user can specify some project-wide settings while on the second page he can configure the master page.

MVC Project Settings

Creation And Configuration Wizard 1.1
Using the controls in the MVC Project Settings page you can modify various project-wide settings:
  • Use CDN Support - Enable or disable CDN support.

Master Page Settings

Creation And Configuration Wizard 2
Using the controls in the Master Page Settings page you can modify the initial behavior of the master page:
  • Skin - Choose which of the predefined Telerik UI element skins to use
  • Combine/Compress StyleSheets - Combine or compress stylesheets (register the asset.axd HTTP handler in web.config)
  • Combine/Compress Scripts - Combine or compress JavaScript (register the asset.axd HTTP handler in web.config)
  • Use Embedded jQuery - Automatically include jQuery or not
  • Enable globalization - Enable or disable globalization or not
  • Render Right-To-Left - Enable right-to-left rendering or not

Project Conversion Wizard

The Project Conversion Wizard converts an existing ASP.NET MVC application to Telerik MVC Application (Telerik menu -> MVC UI Extensions -> Convert to Telerik MVC Application). The convert wizard has two steps - project settings page and master pages settings one.

MVC Project Settings

Creation And Configuration Wizard 1.2
Using the controls in the MVC Project Settings page you can modify various project-wide settings:
  • Version - Choose which version of Telerik Extensions for ASP.NET MVC to use
  • Copy GlobalResources - Copy the localization files to ~/App_GlobalResources or not
  • Copy Editor Templates - Copy the predefined editor templates to ~/Views/Shared/EditorTemplates or not
  • Use CDN Support - Enable or disable CDN support.

Master Page Settings

Creation And Configuration Wizard 2
Using the controls in the Master Page Settings page you can modify the initial behavior of the master page:
  • Skin - Choose which of the predefined Telerik UI element skins to use
  • Combine/Compress StyleSheets - Combine or compress stylesheets (register the asset.axd HTTP handler in web.config)
  • Combine/Compress Scripts - Combine or compress JavaScript (register the asset.axd HTTP handler in web.config)
  • Use Embedded jQuery - Automatically include jQuery or not
  • Enable globalization - Enable or disable globalization or not
  • Render Right-To-Left - Enable right-to-left rendering or not

Special Cases

Two special scenarios may occur while converting or configuring a project. The first scenario is when neither master page nor layout page exists in the project. The second scenario is when both master page and layout page exist in the project. Both scenarios are handled respectively on the Master Page Settings page.

No master page and layout page in the project

Creation And Configuration Wizard 2.1
The wizard gives you the opportunity to create a new master page or layout page so that the user can set the Master Page settings. Depending on the selected view engine the wizard will create master page for ASPX or layout page for Razor.

Master page and layout page in the project

Creation And Configuration Wizard 2.2
You can choose whether you want to apply the selected settings to both the master page and the layout page or only to one of them.