[Expand]General Information
[Expand]WinForms Controls
[Collapse]ASP.NET Controls and MVC Extensions
 [Expand]What's Installed
 [Collapse]Common Concepts
  [Collapse]Web.config Modifications
    Web.config Modifications Overview
   [Expand]Web.config Options
    ConfigSource Attribute
  [Expand]Callback Exception Handling
  [Expand]Client-Side Functionality
  [Expand]Cookies Support
  [Expand]Appearance Customization - Theming
   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]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]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)


ASP.NET's built-in HTTP Handler and Module generates one HTTP request per file and loads these files sequentially when a browser loads a web page. If a web page contains many files (such as scripts, styles, binary data, etc.), its loading can take a significant amount of time.

The DevExpress ASP.NET subscription includes the ASPxHttpHandlerModule (the DevExpress HTTP Handler and Module) that is implemented instead of the standard HTTP Resource handler and increases a web page’s loading speed.

The ASPxHttpHandlerModule can function as both a handler and a module.

Expanded ASPxHttpHandlerModule Registration

Register the ASPxHttpHandlerModule by automatically or manually adding configuration strings to the following Web.Config file sections:

Automatic registration

You can automatically register the ASPxHttpHandlerModule as a module and a handler by adding the required strings to the sections described above in the following cases:

Manual registration

You can add the following strings to the Web.Config file if the ASPxHttpHandlerModule is not registered automatically:

Expanded For version 14.2 and newer

IIS (classic mode)

IIS7 and newer (integrated mode)

Note that you should specify your PublicKeyToken (PublicKeyToken=b88d1754d700e49a" in the example), assembly version (Version=, and assembly name (DevExpress.Web.v19.1) in these strings.

Expanded For version 14.1 and older

IIS (classic mode)

IIS7 and newer (integrated mode)

Note that you need to specify your PublicKeyToken (PublicKeyToken=b88d1754d700e49a" in the example), assembly version (Version=, and assembly name (DevExpress.Web.v14.1) in these strings.


You may also need to register the reporting HTTP handlers if you use reporting controls in your ASP.NET application. See the Registering ASPxHttpHandlerModule for Reporting Controls topic for more information.

Expanded ASPxHttpHandlerModule as a Module

The ASPxHttpHandlerModule has access to ASP.NET application lifecycle events (it is subscribed to an application's PreSendRequestHeaders and AuthenticateRequest events) and can assess incoming requests and modify outbound responses. For example, it can handle server-side exceptions and standard response redirection, as well as check authentication expiration.

The primary ASPxHttpHandlerModule features are listed below.


You can manipulate specific DevExpress options within the Web.Config file to affect how ASPxHttpHandlerModule forms respond. Refer to the Web.Config Options Overview topic to learn more.

Expanded ASPxHttpHandlerModule as a Handler

The optional ASPxHttpHandlerModule handler's functionality allows you to merge and compress custom CSS and JavaScript source files. See How to: Merge and Compress Custom CSS and JavaScript Files to learn more.


The enableResourceCompression option must be set to true (the default value) to enable file compression.

Expanded WebResourceAssembly Attribute

When you create a custom assembly that contains DevExpress resources, set the WebResourceAssembly(assemblyID) attribute - to specify that the assembly can export resources via the ASPxHttpHandlerModule. Set the assemblyID attribute to a value greater than 100 to avoid conflicts (key values from 0 to 100 are reserved for DevExpress controls).

The complete sample project is available at How to create a custom theme assembly.

Expanded See Also

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