Edit this page

Progress®Telerik® UI for ASP.NET MVC

Telerik UI for ASP.NET MVC is a set of server-side wrappers that allows using the Kendo UI widgets from C# or VB.NET code.

This article demonstrates how to download Telerik UI for ASP.NET MVC, install it, and run a sample ASP.NET MVC application.

Requirements

Telerik UI for ASP.NET MVC requires ASP.NET MVC.

The offline sample application requires:

Environments

Telerik UI for ASP.NET MVC supports:

Telerik UI for ASP.NET MVC Visual Studio Extensions support Visual Studio 2010 and later.

Download

To download Telerik UI for ASP.NET MVC:

  1. Log in to your Telerik account.

  2. Click Downloads in the top navigation.

  3. Click UI for ASP.NET MVC. If this option is not available, click one of the following: DevCraft UI Edition, DevCraft Complete or DevCraft Ultimate.

  4. Click Download Installer and other resources.

  5. Find the UI for ASP.NET MVC item, click Browse all product files, and select to download the Telerik online installer (exe file), the MSI installer file directly, or the .zip file.

Installation

Run Telerik UI for ASP.NET MVC installer. The automatic setup will guide you through the rest of the installation. If you chose to download the .zip file, extract it to a location of your preference.

Location

The setup installs Telerik UI for ASP.NET MVC in C:\Program Files (x86)\Progress\UI for ASP.NET MVC<version>.

For versions prior to R3 2017, the default installation folder for Telerik UI for ASP.NET MVC is C:\Program Files (x86)\Telerik\UI for ASP.NET MVC<version>.

Distribution Contents

Telerik UI for ASP.NET MVC contains the following directories:

  • js—These are the minified JavaScript files.
  • styles—The minified CSS files and images used by the themes.
  • src—The complete JavaScript, CSS, and C# source code. Note that this directory is not available in the trial version.
  • spreadsheetTelerik.Web.Spreadsheet assembly and its dependencies from Telerik Document Processing library.
  • wrappers\aspnetmvc\Binaries\MVC3—The assemblies for the ASP.NET MVC 3 applications.
  • wrappers\aspnetmvc\Binaries\MVC4—The assemblies for the ASP.NET MVC 4 applications.
  • wrappers\aspnetmvc\Binaries\MVC5—The assemblies for the ASP.NET MVC 5 applications.
  • wrappers\aspnetmvc\Examples\VS2012—The ASP.NET MVC 4 sample application built with Visual Studio 2012.
  • wrappers\aspnetmvc\Examples\VS2013—The ASP.NET MVC 5 sample application built with Visual Studio 2013.
  • wrappers\aspnetmvc\Examples\VS2015—The ASP.NET MVC 5 sample application built with Visual Studio 2015.
  • wrappers\aspnetmvc\Examples\AspNet.Core—The ASP.NET Core sample application built with Visual Studio 2015.
  • wrappers\aspnetmvc\EditorTemplates—The ready-to-use editor templates based on the Kendo UI widgets.
  • wrappers\aspnetmvc\Scaffolding—The Kendo UI Scaffolder Visual Studio extension. It enables generating the Kendo UI MVC wrapper widgets declarations inside Visual Studio projects and is added in the Kendo UI Q1 2015 release.

Sample Application

Telerik UI for ASP.NET MVC comes with a sample ASP.NET MVC application available in 2 versions:

  • The ASP.NET MVC 4 application built with Visual Studio 2012.
  • The ASP.NET MVC 5 application built with Visual Studio 2013.

Running the Sample Application

To run the sample application:

  1. Navigate to the installation directory of Telerik UI for ASP.NET MVC.

  2. Open the sample Visual Studio Solution:

  • To run the ASP.NET MVC 4 version, open wrappers\aspnetmvc\Examples\VS2012\Kendo.Mvc.Examples.sln with Visual Studio 2012.
  • To run the ASP.NET MVC 5 version, open wrappers\aspnetmvc\Examples\VS2013\Kendo.Mvc.Examples.sln with Visual Studio 2013.

  1. Press CTRL+F5 to build and run the application.

  2. A browser loads the start page of the sample application. Use the links to explore the available demos.

    Figure 1 The start-up screen of the sample application

    Telerik UI for ASP.NET MVC Sample Application

Distribution Contents

The sample application Visual Studio solution contains the following items:

  • Areas/aspx/Views—WebForm views.
  • Areas/razor/Views—Razor views.
  • Controllers—Controller classes.
  • Models—Model classes.
  • App_Data—LocalDB sample database.

Upgrade

You can upgrade the version of the Telerik UI for ASP.NET MVC wrappers and also switch from a trial to a developer license.

Upgrade to Newer Versions

To update Telerik UI for ASP.NET MVC to a new version, either:

Automatic Upgrade

To utilize the Upgrade Project Wizard, refer to the articles on:

  1. Downloading new versions
  2. Upgrading the Project Wizard

Manual Upgrade

To manually upgrade to a newer Telerik UI for ASP.NET MVC version:

  1. Replace all scripts, styles, and images related to Telerik UI for ASP.NET MVC with the desired version of the framework. Download the desired version from the Download section of your account.
  2. Change the reference to the new Kendo.MVC dll. Verify that the dll refers to the correct ASP.NET MVC version.

Upgrade From Trial to Licensed Versions

  1. Before upgrading to a licensed version, delete (uninstall) the trial version from your machine. This eliminates the possibility for trial assemblies to end up in the project references or in production.
  2. Install the licensed Kendo UI version and follow the steps for updating the Telerik UI for ASP.NET MVC version.

Troubleshooting

I Am Still Getting the Old Version

Sometimes the .NET Framework caches the old Kendo.MVC dll. As a result, the upgrade may seem to have failed.

Solution

  1. From the Windows Task Manager, terminate the IIS process and close Visual Studio.
  2. Clean up the Temporary ASP.NET files from <sysdrive>:\Windows\Microsoft.NET\Framework[64] <vernum>\Temporary ASP.NET Files.
  3. Delete your browser cache. For Internet Explorer, select Tools > Internet Options > Delete Files.
  4. Clean up the Windows WebSite Cache from \Users<UserName>\AppData\Local\Microsoft\WebsiteCache. The location of this cache may vary from one operating system to another.
  5. Clean up the Visual Studio Backup from <sysdrive>:\Users\<UserName>\Documents\Visual Studio <vsVersion>\Backup Files. The exact location depends on your Visual Studio settings and installation.

The Icons Are Missing after the Upgrade

As of the Kendo UI R1 2017 release, the Telerik UI for ASP.NET MVC uses font icons, which might lead to compatibility issues.

Solution

If you upgrade your project from a prior version to the R1 2017 version (2017.1.118) or later, you have to change the classes of the custom CSS rules that you use accordingly.

If the icons are still missing after you change the classes, verify that the version is fully updated.

Next Steps

After you run the sample application, read through the following articles, related to Telerik UI for ASP.NET MVC:

See Also