Edit this page

Overview of Progress® Telerik® UI for ASP.NET Core

Telerik UI for ASP.NET Core is a set of server-side wrappers that allows using the Kendo UI widgets in .NET Core.

This article demonstrates how to use Telerik UI for ASP.NET Core in ASP.NET Core applications.

The Basics

Supported Environments

Telerik UI for ASP.NET Core targets the stable releases of the ASP.NET Core framework.

The target runtime is CoreCLR. The full desktop CLR is also supported.

Resources

To get started, refer to the ASP.NET Core Documentation.

The repositories below contain source code, instructions, and issue trackers for the ASP.NET project. These are immensely useful when you need to track down particular issues or behaviors.

Requirements

Telerik UI for ASP.NET Core requires .NET Core.

The offline sample application requires:

Download

To download Telerik UI for ASP.NET Core:

  1. Log in to your Telerik account.

  2. Click Downloads in the top navigation.

  3. Click Progress® Telerik® UI for ASP.NET Core.

  4. In the Installation section select to download the Telerik online installer (exe file), the MSI installer file directly.

The Telerik UI for ASP.NET Core suite can be included in a project via NuGet without locally installing the suite on the machine. Further information on how to configure such application could be found in the Getting Started article.

Installation

Run Telerik UI for ASP.NET Core installer. The automatic setup will guide you through the rest of the installation.

Location

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

Distribution Contents

Telerik UI for ASP.NET Core 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.
  • typescript—The TypeScript definitions for the Kendo combined scripts (kendo.all, kendo.dataviz, kendo.web and kendo.mobile).
  • vsdoc—The intellisense definitions for the Kendo combined scripts (as the above).
  • VSExtensions—The extensions for Visual Studio 2015 and 2017.
  • wrappers\aspnetcore\Binaries\AspNet.Core—Containing the .nupkg NuGet package file.
  • wrappers\aspnetcore\Examples\AspNet.Core\VS2015—The ASP.NET Core sample application built with Visual Studio 2015.
  • wrappers\aspnetcore\Examples\AspNet.Core\VS2017—The ASP.NET Core sample application built with Visual Studio 2017.
  • wrappers\aspnetcore\EditorTemplates\razor—The ready-to-use editor templates based on the Kendo UI widgets.

Sample Application

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

  • The .NET Core application built with Visual Studio 2015.
  • The .NET Core application built with Visual Studio 2017.

This sample application is an offline version of the Telerik UI for ASP.NET Core Demos.

Running the Sample Application

To run the sample application:

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

  2. Open the sample Visual Studio Project:

  • Open wrappers\aspnetcore\Examples\AspNet.Core\VS2015\Kendo.Mvc.Examples\Kendo.Mvc.Examples.xproj with Visual Studio 2015; or
  • Open wrappers\aspnetcore\Examples\AspNet.Core\VS2017\Kendo.Mvc.Examples\Kendo.Mvc.Examples.xproj with Visual Studio 2017.

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

Distribution Contents

The sample application Visual Studio Project contains the following items:

  • Views—the Razor views.
  • Controllers—Controller classes.
  • Models—Model classes.
  • wwwroot—the web app root, containing the LocalDB sample database (in the App_Data folder) and the other client resources (libraries, scripts, styles and others).

Upgrade

You can upgrade the version of the Telerik UI for ASP.NET Core 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:

  • Upgrade with NuGet and Bower, or
  • Manually replace the references and files.

Upgrade with NuGet and Bower

To upgrade the version with NuGet and Bower:

  1. In Visual Studio open the NuGet Package Manager on the Installed tab and click Update for the Telerik.UI.for.AspNet.Core package;
  2. In Visual Studio open the Bower Package Manager on the Installed tab and click Update for the kendo-ui package;
  3. Manually replace in the application any references pointing to the old Kendo UI resource files (scripts and styles).

Note, that both NuGet and Bower require authentication in order to properly load Telerik and Kendo packages.

Manual Upgrade

  1. Download the desired version from the Download section of your account;
  2. Replace all scripts, styles, and images related to Telerik UI for ASP.NET Core with the desired version of the framework;
  3. Change the reference to the new Kendo.MVC dll. Verify that the dll refers to the correct ASP.NET Core version;
  4. Manually replace in the app any references pointing to the old Kendo UI resource files (scripts and styles).

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 Core version.

See Also