Starting in Telerik UI for ASP.NET MVC with a Project Template

Welcome to the Getting Started with Progress^® Telerik^® UI for ASP.NET MVC in Visual Studio tutorial!

The fastest way to start with Telerik UI is with a project template, but you can also manually add the Telerik controls to an existing application.

This tutorial guides you through implementing the Telerik UI for ASP.NET MVC Grid and Datepicker in a new application. To create the application, you will use the project template provided by the Visual Studio Extensions that come with the Telerik UI for ASP.NET MVC installation.

The Telerik extensions streamline the Telerik UI for ASP.NET MVC setup by automatically adding the necessary references and configuration. These extensions also provide a wizard that can configure an existing ASP.NET MVC application for the Telerik controls.

Other popular approaches for starting with Telerik UI for ASP.NET MVC include:

• Setup with Telerik NuGet—this method allows you to download the Telerik controls by using the NuGet package manager in Visual Studio.
• Manual setup with local files—with this method, you add the Kendo.Mvc.dll assembly to your project by using local files. This assembly enables you to use the Telerik UI components.

How about a free Telerik UI onboarding course? Check out the Video Onboarding article and learn how to take advantage of the Telerik Virtual Classroom.

Prerequisites

• Telerik UI for ASP.NET MVC requires the .NET Framework.

• Visual Studio 2012 or later.

  For Visual Studio 2017 or later, you must install the ASP.NET & web development workload. See Microsoft's Install Visual Studio workloads documentation for guidance.

• Telerik account.

Downloading and Installing

Follow these steps to download and install Telerik UI for ASP.NET MVC:

1. Log in to your Telerik account.

   If you don't have a Telerik account yet, you can create one for free.

2. Download the installation file:

   • To get the free trial version, follow this link to download UI for ASP.NET MVC. The installer will activate your trial when you complete the installation.

   • If you have already purchased a license:

     1. Click Downloads in the top navigation bar of your Telerik account.

     2. Click UI for ASP.NET MVC.

     3. Download the .msi installer file from the Installation section.

3. Close any running Visual Studio instances and run the Telerik UI for ASP.NET MVC installer. The automatic setup will guide you through the rest of the installation. The Telerik Visual Studio Extensions are installed by default.

The default installation folder is C:\Program Files (x86)\Progress\Telerik UI for ASP.NET MVC<version>.

Creating a Telerik ASP.NET MVC Application

After the Visual Studio Extensions are installed, create a Telerik ASP.NET MVC application by using the Create New Project wizard in Visual Studio.

1. In the Visual Studio toolbar, click File > New > Project.

2. Search for and select the Telerik ASP.NET MVC C# project template. Click Next.

   

3. Select the GRID AND MENU template.

   For more information on the additional predefined Telerik template options, refer to the Creating New Projects article.

   

4. Select the Default-v2 visual theme for your Telerik ASP.NET MVC Application, and click Finish to complete the creation of the application.

The newly created application already has a reference to the required Kendo.Mvc.dll assembly. The wizard also references the client-side resources (the Kendo UI script and theme-related CSS files) in the _Layout.cshtml.

You can now start adding components.

• Find more information about Creating new Telerik Projects in this article.

Adding Components to the Application

As a result of selecting the GRID AND MENU template, a Grid component has been added to the Index.cshtml view, and a Menu to the _Layout.cshtml. The Grid is configured and bound remotely to sample data returned by the GridController. The next step is to add an additional component to the application.

Add a DatePicker to the Index.cshtml view:

    <h4>Telerik UI for ASP.NET MVC DatePicker:</h4>

    @(Html.Kendo().DatePicker()
        .Name("datepicker") // The Name of the DatePicker is mandatory. It specifies the "id" attribute of the component.
        .Value(DateTime.Today) // Sets the value of the DatePicker.
    )

Building and Running the Application

Press CTRL+F5 to build and run the application. You have a Grid and a DatePicker on your page.

Adding Your License File

Using any client-side assets from the Kendo UI CDN or the @progress/kendo-ui NPM package requires you to add a Kendo UI for jQuery license file to your application. A missing license file triggers a banner, a watermark, and causes a warning message in the browser's console.

To generate your license file and add it to your application, follow the instructions in the Adding a License File article.

Next Steps

• Explore the Telerik UI for ASP.NET MVC fundamentals
• Grid Data Binding Overview
• Integrate Telerik UI for ASP.NET MVC in Visual Studio

See Also

• Exploring the Helper Script Dependencies
• Integrate Telerik UI for ASP.NET MVC in Visual Studio
• Upgrade Telerik UI for ASP.NET MVC
• Collected Examples on ASP.NET MVC
• Collected Examples on Telerik UI for ASP.NET MVC
• Migrating from MVC to Core MVC
• MS - Upgrade from ASP.NET Framework to ASP.NET Core