Skip to content

Latest commit

 

History

History
132 lines (78 loc) · 7.82 KB

first-steps.md

File metadata and controls

132 lines (78 loc) · 7.82 KB
title page_title description slug previous_url position permalink
Using a Project Template
Using a Project Template
Create a sample project with Progress Telerik UI for ASP.NET MVC components by starting with a Telerik template on Visual Studio.
gettingstarted_aspnetmvc
/getting-started/asp-net-mvc-5
1
/getting-started/first-steps

Starting in {{ site.product }} 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]({% slug manualsetup_aspnetmvc%}).

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]({% slug overview_visualstudio_aspnetcore %}) 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]({% slug convertprojectwizard_visualstudio_aspnetcore %}) for the Telerik controls.

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

  • [Setup with Telerik NuGet]({% slug setupwithnuget_aspnetmvc %})—this method allows you to download the Telerik controls by using the NuGet package manager in Visual Studio.
  • [Manual setup with local files]({% slug manualsetup_aspnetmvc%})—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.

tip How about a free Telerik UI onboarding course? Check out the [Video Onboarding]({%slug virtualclass_uiformvc%}) article and learn how to take advantage of the Telerik and Kendo UI Video Courses.

Prerequisites

Downloading and Installing

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

  1. Log in to your Telerik account.

    tip 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.

    {{ site.product_short }} Create a new Telerik application

  3. Configure the project. Click Create.

    {{ site.product_short }} Configure the project

  4. Select the GRID AND MENU template. Click Next.

    For more information on the additional predefined Telerik template options, refer to the [Creating New Projects]({% slug newprojectwizards_visualstudio_aspnetcore %}) article.

    {{ site.product_short }} New Project Wizard templates

  5. Choose a Theme. Click Finish.

{{ site.product_short }} Choose a Theme

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.

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.

{{ site.product_short }} Sample page showing a Grid and a DatePicker

Adding Your License File

Using any client-side assets from the [Kendo UI CDN]({% slug cdnservices_core %}) or the @progress/kendo-ui NPM package requires you to add a Telerik license file to your application. A missing license file triggers [a banner, a watermark, and causes a warning message]({% slug troubleshooting-license-key-errors %}) in the browser's console.

To generate your license file and add it to your application, follow the instructions in the [Installing a License File]({% slug installation_license_key_aspnetcore %}).

Next Steps

  • [Explore the Telerik UI for ASP.NET MVC fundamentals]({% slug fundamentals_aspnetmvc %})
  • [Grid Data Binding Overview]({% slug htmlhelpers_grid_aspnetcore_binding_overview %})
  • [Integrate Telerik UI for ASP.NET MVC in Visual Studio]({% slug overview_visualstudio_aspnetcore %})
  • [Create a New Telerik UI for ASP.NET MVC Application through Visual Studio Extension]({% slug newprojectwizards_visualstudio_aspnetcore %})

See Also