[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
  [Collapse]Appearance Customization - Theming
    DevExpress Themes Overview
    Available Themes
    ASPxThemes Assembly
    Modifying Themes
    Changing Theme Base Color and Font Settings
    ASPxThemeDeployer Tool
    ASPxThemeBuilder Tool
    Apply a Theme with the DevExpress Mechanism
    Apply a Theme with the ASP.NET Mechanism
    Attaching a Custom Theme Assembly
    DevExpress Resource Management Mechanism
   [Expand]Obsolete Approaches (prior to 2012.1)
   Icon Collection
  [Expand]Performance Optimization
  [Expand]CSS Image Sprites
   Data Annotation Attributes
   Supported Document Types
  [Expand]Accessibility Support
   Right to Left Support
   HTML Encoding
  [Expand]SharePoint Support
   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]eXpress Persistent Objects
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

DevExpress Themes Overview

DevExpress ASP.NET controls ship with predefined visual themes (DevExpress Themes) that allow you to provide a consistent appearance across all DevExpress controls. Refer to the Available Themes topic for a list of DevExpress Themes.

Because DevExpress Themes are based on Microsoft's themes and skins technology (see the ASP.NET Themes and Skins topic in MSDN for details), if you are familiar with a standard ASP.NET Theme implementation, you can work with DevExpress Themes in a similar way. Use the ASPxThemeDeployer tool to apply a DevExpress theme to a specific web page or an entire project. See Apply a Theme with the ASP.NET Mechanism to learn more.

Also, starting with v12.1, we released a DevExpress mechanism to simplify the maintenance and application of DevExpress themes. These themes can be applied to an individual DevExpress web control, or to an entire website. This approach to theming is detailed below.

Expanded Maintaining DevExpress Themes

By design, all pre-packaged DevExpress Themes are included in the ASPxThemes assembly, which is registered within the GAC (refer to ASPxThemes Assembly to learn more). This does not include the Default Theme, which is already a part of the control-related DLLs.

All DevExpress Themes exposed by ASPxThemes.dll are automatically made available within web projects via the DevExpress ASPxHttpHandlerModule. This module is responsible for the immediate retrieval of required theme resource files from the assembly (when requested), without the need to store these files within the application's App_Theme folder.

This approach to maintaining themes in an assembly and obtaining required theme resources from it provides the following benefits.

  • Ease of Upgrade

    You can upgrade your project to a newer version of DevExpress ASP.NET controls without the need to redeploy resource files for predefined themes to the App_Theme folder.

  • Ease of Application

    You can apply predefined DevExpress themes in different ways (using different resources) depending on your objective. See the following section for more details.

Expanded Applying DevExpress Themes

In v12.1, we introduced programmatic (in code behind or via the global.asax file) and declarative (via the web.config file's configuration options) approaches to applying a DevExpress Theme to a single web control, all web controls, or an entire website - as listed in the table below.

Member Description
Control property: ASPxWebControl.Theme Gets or sets the name of the Theme to be applied to the control.
Static property: ASPxWebControl.GlobalTheme Gets or sets the name of the Theme to be globally applied to all DevExpress web controls across the entire web site.
Static property: ASPxWebControl.GlobalStyleSheetTheme Gets or sets the name of the style sheet theme to be globally applied to all DevExpress web controls across the entire web site.
Static property: ASPxWebControl.GlobalThemeBaseColor Gets or sets the base color for the theme to be globally applied to all DevExpress web controls across a web page or entire web site.
Static property: ASPxWebControl.GlobalThemeFont Gets or sets the font settings of the theme to be globally applied to all DevExpress web controls across a web page or entire web site.
Web.config option: Theme Name Specifies the name of a default or custom visual theme to be globally applied to all DevExpress controls within a website.
Web.config option: Style Sheet Theme Name Specifies the name of a default or custom style sheet theme to be applied to all DevExpress controls within a website.
Web.config option: Theme Base Color Specifies the name of the base color for the theme that will be globally applied to all DevExpress controls within a website.
Web.config option: Theme Font Settings Specifies the font settings for the theme that will be globally applied to all DevExpress controls within a website.

Refer to the Apply a Theme with the DevExpress Mechanism topic for detailed information on how to apply a DevExpress theme.

Expanded See Also

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