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 2015 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—A README file which states that as of R2 2016 the source code is distributed in separate .source.zip packages that are located in your account.
  • Scaffolding—The Kendo UI Scaffolder Visual Studio extension. It enables the generation of the Kendo UI MVC wrapper widget declarations inside Visual Studio projects and is added to the Kendo UI Q1 2015 release.
  • spreadsheetTelerik.Web.Spreadsheet assembly and its dependencies from Telerik Document Processing library.
  • pdfviewerTelerik.Web.PDF 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\VS2017—The ASP.NET MVC 5 sample application built with Visual Studio 2017.
  • wrappers\aspnetmvc\EditorTemplates—The ready-to-use editor templates based on the Kendo UI widgets.

Sample Application

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

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

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, 2015, and 2017.

  1. Install Microsoft .NET 4.6.2 Framework Developer Pack.

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

  3. A browser loads the start page of the sample application.

Sample Application Contents

The sample application Visual Studio solution contains the following items:

  • 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. Load the scripts and styles locally or from the Kendo UI CDN Services.
  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

Kendo.Mvc.Examples upgraded to 4.6.2

The examples project is 4.6.2 targetFramework. Installation of Microsoft .NET Framework 4.6.2 is required. If you cannot install it, you could switch the targetFramework to 4.5 and run the examples without using Telerik.Web.PDF dependency. Telerik.Web.PDF is a netstandard project that uses DPL libraries to convert PDF documents into json that is utilized by the PDFViewer component.

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

In this article
Not finding the help you need? Improve this article