[Expand]General Information
[Expand]WinForms Controls
[Collapse]ASP.NET Controls and MVC Extensions
 [Expand]Prerequisites
 [Expand]What's Installed
 [Collapse]Common Concepts
  [Expand]Web.config Modifications
  [Expand]Callback Exception Handling
  [Expand]Client-Side Functionality
  [Expand]Cookies Support
  [Expand]Appearance Customization - Theming
   Icon Collection
  [Expand]Performance Optimization
  [Expand]CSS Image Sprites
   Supported Document Types
  [Expand]Accessibility Support
   Right to Left Support
   HTML Encoding
   Binary Storage Configuration
  [Collapse]SharePoint Support
   [Expand]Ready to Use Web Parts
   [Collapse]Developer Capabilities
     Installation and Deployment
     Upgrading to a Newer Version
     Visual Web Part Creation
     SharePoint Page Editing
     Web Part Creation
    SharePoint Troubleshooting Guide
   Mobile Support
  [Expand]Office Document Management
   Cloud Storage Account Management
  [Expand]Web Farm and Web Garden Support
 [Expand]ASP.NET WebForms Controls
 [Expand]ASP.NET MVC Extensions
 [Expand]Localization
 [Expand]Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

SharePoint Page Editing

This section describes how to embed DevExpress ASP.NET controls in the SharePoint Page directly using the SharePoint Designer.

Expanded Requirements

  • In this tutorial, the following assemblies are used.

    • DevExpress.Data - the core DevExpress assembly
    • DevExpress.Web - contains the main ASP.NET product code
    • DevExpress.Web.ASPxThemes - contains the skins and theme resources for DevExpress ASP.NET products

    These assemblies should be registered in the GAC. If they have not yet been registered, deploy them with the “gacutil” (the “c:\Program Files (x86)\Microsoft SDKs\Windows\v8.0A\bin\NETFX 4.0 Tools\gacutil.exe” path for .NET v4) tool using the following commands.

    gacutil –i DevExpress.Data.v18.1.dll
    gacutil –i DevExpress.Web.v18.1.dll
    gacutil –i DevExpress.Web.ASPxThemes.v18.1.dll
  • Register the ASPxHttpHandlerModule module entry in the target SharePoint site Web.config (see the Developer Capabilities -> Installation table for more information) - as demonstrated in the code sample below.

    • Registration for Version 14.2 and newer
    • Registration for Version 14.1 and older
  • Register the ASPxUploadProgressHttpHandler handler entry in the target SharePoint site Web.config (see the Developer Capabilities -> Installation table for more information). The code sample below demonstrates how to register the ASPxUploadProgressHttpHandler handler.

    • Registration for Version 14.2 and newer
    • Registration for Version 14.1 and older
  • Mark each namespace/control from DevExpress assemblies to be used on the SharePoint Page as safe to use. See the How to: Mark Controls as Safe Controls MSDN article for more information. The code sample below demonstrates how to mark the DevExpress controls as safe.

  • Register the DevExpress assemblies to be used in the corresponding Web.config section (as you do for a regular ASP.NET WebApplication) – as shown in the code sample below. See the assemblies Element for compilation (ASP.NET Settings Schema) MSDN article to learn more.

Expanded Editing the SharePoint Page

This tutorial demonstrates how to replace the default QuickLaunch menu with ASPxNavBar.

  1. Open the SharePoint site in the SharePoint Designer.
  2. Edit the "seattle.master" Master Page in Advanced Mode.
  3. Add the following Register directive to the corresponding Master Page section.

    <%@ Register Assembly="DevExpress.Web.v18.1, Version=18.1.6.0, Culture=neutral, PublicKeyToken=b88d1754d700e49a" Namespace="DevExpress.Web" TagPrefix="dx" %>
  4. Define the ASPxNavBar control.

  5. Since ASPxNavBar can be bound to a hierarchical datasource, it is possible to use ASPxNavBar instead of the default QuickLaunchMenu.

Expanded Applying Themes

DevExpress ASP.NET controls ship with 18 built-in skins. You can set the ASPxNavBar.Theme property to “MetropolisBlue”, for example, to create an appearance that is consistent with the SharePoint 2013/Office 365 color scheme.

The code sample below illustrates how to define the control's Theme property.

You can specify a theme for an individual control or the entire application. See the DevExpress Themes Overview help topic for more information.

When working with Sharepoint WebPart / VisualWebPart modules, override the CreateChildControls method to apply a theme.

Expanded See Also

Is this topic helpful?​​​​​​​