Prerequisites and Installation
This topic shows how to download and install DevExtreme ASP.NET MVC Wrappers and then run a sample ASP.NET MVC application.
Environment and Requirements
DevExtreme ASP.NET MVC Wrappers support:
- .NET Framework 4.0 and later / .NET Core 1.0.1 and later
- ASP.NET MVC 3 and later
- Visual Studio 2012 and later
- Visual Studio 2012 Update 5
- ASP.NET and Web Tools 2013.1 for Visual Studio 2012
- KB3002339 hotfix
Apart from the libraries required by DevExtreme itself, DevExtreme ASP.NET MVC Wrappers have the following dependencies.
Download and Installation
Download the DevExtreme installer (.exe file) here and run it. The setup wizard will guide you through the installation steps.
After installation is completed, you can create a new project that includes all the resources required by ASP.NET MVC Wrappers (see Project Templates). If you already have a project, add these resources manually using the instructions below.
ASP.NET MVC 3, 4, 5
Use this tool for Visual Studio.
ASP.NET Core MVC
Create a NuGet.config file in the root directory of your project. Copy and paste the following strings to this file. Note that if you changed the default installation path, the
valueattribute must be given this path.
<?xml version="1.0" encoding="utf-8"?> <configuration> <packageSources> <add key="devextreme-wrappers-netcore" value="C:\Program Files (x86)\DevExpress 16.2\DevExtreme\System\Bin\AspNetCore" /> </packageSources> </configuration>
Add the following string to the project.json file into the
Add the following strings to the bower.json file into the
"jquery": "~3.1", "devextreme": "~16.2", "devextreme-aspnet-data": "~1"NOTEIf the bower.json file is absent, run the console in the project directory and execute the
bower initcommand in it.
Copy the dx.aspnet.mvc.js script from C:\Program Files (x86)\DevExpress 16.2\DevExtreme\Sources\Lib\js\aspnet to the wwwroot directory of your project.
Copy and paste the following strings to the Views/Shared/_Layout.cshtml file into the
<link href="~/lib/devextreme/css/dx.common.css" rel="stylesheet" /> <link href="~/lib/devextreme/css/dx.light.css" rel="stylesheet" /> <script src="~/lib/jquery/dist/jquery.js"></script> <script src="~/lib/devextreme/js/dx.all.js"></script> <script src="~/lib/devextreme-aspnet-data/js/dx.aspnet.data.js"></script> <script src="~/dx.aspnet.mvc.js"></script>
Add the following string to the Views/_ViewImports.cshtml file.
DevExtreme ASP.NET MVC Wrappers come with two sample applications that show how to configure almost every widget from the DevExtreme library. They demonstrate identical use-cases, but one of them is built using ASP.NET MVC 5 and Visual Studio 2012, while the other targets ASP.NET Core MVC. You can find both applications in the C:\Users\Public\Public Documents\DevExpress Demos 16.2\DevExtreme\ASP.NET MVC Wrappers (RC)\ directory.