Progress® Telerik® UI for ASP.NET Core

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

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

Supported Environments

Telerik UI for ASP.NET Core targets the stable releases of the ASP.NET Core framework. The target runtime is CoreCLR. The UI for ASP.NET Core suite also supports the full desktop CLR.

Resources

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

To facilitate the process of tracking down particular issues or behaviors, use the following repositories which contain source code, instructions, and issue trackers for the ASP.NET project.

Setup

To set up and install Telerik UI for ASP.NET Core, refer to the following sections:

Prerequisites

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 the Telerik UI for ASP.NET Core installer. The automatic setup will guide you through the rest of the installation. 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\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 which is an offline version of the Telerik UI for ASP.NET Core Demos. The sample application is available in the following versions:

  • The .NET Core application built with Visual Studio 2017

Important

As of the Kendo UI R2 2018 release, the Visual Studio 2015 version of the sample application is no longer distributed because of its deprecated format and limited tooling support.

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:

    • (For Visual Studio 2017) Open wrappers\aspnetcore\Examples\AspNet.Core\VS2017\Kendo.Mvc.Examples\Kendo.Mvc.Examples.xproj.

  3. 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—The Controller classes.
  • Models—The Model classes.
  • wwwroot—The web application root which, in the App_Data folder, contains the LocalDB sample database and the other client resources such as 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. In the application, manually replace any references which point to the old Kendo UI resource files such as scripts and styles.

Important

To properly load the Telerik and Kendo UI packages, both NuGet and Bower require authentication.

Manual Upgrade

  1. Download the desired version from the Download section of your account.
  2. Replace all scripts, styles, and images that are 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 and verify that the dll refers to the correct ASP.NET Core version.
  4. In the application, manually replace any references which point to the old Kendo UI resource files such as scripts and styles.

Upgrade from Trial to Licensed Versions

  1. Before you upgrade to a licensed version, delete (uninstall) the trial version from your machine. This deletion 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

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