Get Started

  • 3 minutes to read

Before your proceed, please review our system requirements.

Use a DevExpress Template to Create a New Project

This section explains how to create a project with the Web Site project template. You can use the same approach to create a web application.

Use the DevExpress Template Gallery to create a new project and configure it for DevExpress ASP.NET Web Forms controls.

  1. In Visual Studio, press Ctrl+Shift+N or select FileNewProject… to create a project. In the invoked dialog, select DevExpress Web Site Template Gallery and click Next.

    Get Started - Create New Project

  2. Configure project settings and click Create.

  3. In the Template Gallery, select a project template and click Run Wizard.

    Get Started - Choose the template

    Every template runs the Project Wizard that allows you to customize web project settings.

  4. In the invoked DevExpress ASP.NET Project Wizard, customize project settings and click Create Project.

    Get Started - Customize the project settings

Integrate DevExpress Controls into an Existing Project

  1. Click the Extensions menu item in Visual Studio (skip this step for Visual Studio 2017).

  2. Select DevExpressASP.NET ControlsRun Wizard to Update Project.

  3. Customize project settings (optional) and click Update Project.

    Get Started - Project Updater

  4. The Wizard adds the DevExpress sections to the Web.config file that are necessary for a project to work correctly.

    <configuration>
    <configSections>
        <sectionGroup name="devExpress">
        <section name="themes" type="DevExpress.Web.ThemesConfigurationSection, DevExpress.Web.v21.1, Version=21.1.4.0, Culture=neutral, PublicKeyToken=b88d1754d700e49a" requirePermission="false" />
        <section name="compression" type="DevExpress.Web.CompressionConfigurationSection, DevExpress.Web.v21.1, Version=21.1.4.0, Culture=neutral, PublicKeyToken=b88d1754d700e49a" requirePermission="false" />
        <section name="settings" type="DevExpress.Web.SettingsConfigurationSection, DevExpress.Web.v21.1, Version=21.1.4.0, Culture=neutral, PublicKeyToken=b88d1754d700e49a" requirePermission="false" />
        <section name="errors" type="DevExpress.Web.ErrorsConfigurationSection, DevExpress.Web.v21.1, Version=21.1.4.0, Culture=neutral, PublicKeyToken=b88d1754d700e49a" requirePermission="false" />
        <section name="resources" type="DevExpress.Web.ResourcesConfigurationSection, DevExpress.Web.v21.1, Version=21.1.4.0, Culture=neutral, PublicKeyToken=b88d1754d700e49a" requirePermission="false" />
        </sectionGroup>
        ...
    </configSections>
    ...
    <system.web>
    ...
        <pages>
            <assemblies>
                <add assembly="DevExpress.Data.v21.1, Version=21.1.4.0, Culture=neutral, PublicKeyToken=b88d1754d700e49a" />
                <add assembly="DevExpress.Web.ASPxThemes.v21.1, Version=21.1.4.0, Culture=neutral, PublicKeyToken=b88d1754d700e49a" />
                <add assembly="DevExpress.RichEdit.v21.1.Core, Version=21.1.4.0, Culture=neutral, PublicKeyToken=b88d1754d700e49a" />
                <add assembly="DevExpress.RichEdit.v21.1.Export, Version=21.1.4.0, Culture=neutral, PublicKeyToken=b88d1754d700e49a" />
                <add assembly="DevExpress.Printing.v21.1.Core, Version=21.1.4.0, Culture=neutral, PublicKeyToken=b88d1754d700e49a" />
                <add assembly="DevExpress.Web.v21.1, Version=21.1.4.0, Culture=neutral, PublicKeyToken=b88d1754d700e49a" />
            </assemblies>
            ...
            <httpHandlers>
                <add type="DevExpress.Web.ASPxUploadProgressHttpHandler, DevExpress.Web.v21.1, Version=21.1.4.0, Culture=neutral, PublicKeyToken=b88d1754d700e49a" verb="GET,POST" path="ASPxUploadProgressHandlerPage.ashx" validate="false" />
                <add type="DevExpress.Web.ASPxHttpHandlerModule, DevExpress.Web.v21.1, Version=21.1.4.0, Culture=neutral, PublicKeyToken=b88d1754d700e49a" verb="GET" path="DX.ashx" validate="false" />
            </httpHandlers>
            <httpModules>
                <add type="DevExpress.Web.ASPxHttpHandlerModule, DevExpress.Web.v21.1, Version=21.1.4.0, Culture=neutral, PublicKeyToken=b88d1754d700e49a" name="ASPxHttpHandlerModule" />
            </httpModules>
            <controls>
                <add tagPrefix="dx" namespace="DevExpress.Web" assembly="DevExpress.Web.v21.1, Version=21.1.4.0, Culture=neutral, PublicKeyToken=b88d1754d700e49a" />
            </controls>
        </pages>
    </system.web>
    <system.webServer>
    ...
        <modules runAllManagedModulesForAllRequests="true">
            <add type="DevExpress.Web.ASPxHttpHandlerModule, DevExpress.Web.21.1, Version=21.1.4.0, Culture=neutral, PublicKeyToken=b88d1754d700e49a" name="ASPxHttpHandlerModule" />
        </modules>
        <handlers>
            <add type="DevExpress.Web.ASPxUploadProgressHttpHandler, DevExpress.Web.v21.1, Version=21.1.4.0, Culture=neutral, PublicKeyToken=b88d1754d700e49a" verb="GET,POST" path="ASPxUploadProgressHandlerPage.ashx" name="ASPxUploadProgressHandler" preCondition="integratedMode" />
            <add type="DevExpress.Web.ASPxHttpHandlerModule, DevExpress.Web.v21.1, Version=21.1.4.0, Culture=neutral, PublicKeyToken=b88d1754d700e49a" verb="GET" path="DX.ashx" name="ASPxHttpHandlerModule" preCondition="integratedMode" />
        </handlers>
    </system.webServer>
    <devExpress>
        <resources>
            <add type="ThirdParty" />
            <add type="DevExtreme" />
        </resources>
        <themes enableThemesAssembly="true" styleSheetTheme="" theme="Office365" customThemeAssemblies="" baseColor="" font="" />
        <compression enableHtmlCompression="false" enableCallbackCompression="true" enableResourceCompression="true" enableResourceMerging="true" />
        <settings accessibilityCompliant="false" bootstrapMode="" doctypeMode="Html5" rightToLeft="false" checkReferencesToExternalScripts="true" protectControlState="true" ieCompatibilityVersion="edge" />
        <errors callbackErrorRedirectUrl="" />
    </devExpress>
    ...
    </configuration>
    

See Also