ASPxUploadProgressHttpHandler

• Jun 21, 2024
• 2 minutes to read

ASPxUploadControl uses ASPxUploadProgressHttpHandler in addition to the standard ASPxHttpHandlerModule. This handler is required to correctly process file uploads in advanced upload mode and to support upload progress indication (enabled via the ASPxUploadControl.ShowProgressPanel property).

ASPxUploadProgressHttpHandler processes service callbacks (automatically initiated by ASPxUploadControl ) to send an uploaded file packet to the server and to obtain file upload progress information from the server. Since these service callbacks are intercepted and processed by ASPxUploadProgressHttpHandler, a standard page HTTP handler is not used and Page events (Page_Init, Page_Load etc.) are not called.

Automatic Registration

ASPxUploadProgressHttpHandler is registered automatically in the following cases:

• When you create a web application via a DevExpress project template;
• When you add ASPxUploadControl to a form in Design View, or add a control in Source View and switch to Design View.

Note

If one of the sections where ASPxUploadProgressHttpHandler should be registered contains the configSource Attribute attribute, ASPxUploadProgressHttpHandler will not be registered automatically.

Manual Registration

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

IIS (classic mode)

XML

<system.web>
     <httpHandlers>
          <add type="DevExpress.Web.ASPxUploadProgressHttpHandler, DevExpress.Web.v25.1, Version=25.1.7.0, Culture=neutral,
            PublicKeyToken=b88d1754d700e49a" verb="GET,POST" path="ASPxUploadProgressHandlerPage.ashx" validate="false" />
     </httpHandlers>
</system.web>

IIS7 (integrated mode)

XML

<system.web>
     <httpHandlers>
          <add type="DevExpress.Web.ASPxUploadProgressHttpHandler, DevExpress.Web.v25.1, Version=25.1.7.0, Culture=neutral, 
          PublicKeyToken=b88d1754d700e49a" verb="GET,POST" path="ASPxUploadProgressHandlerPage.ashx" validate="false" />
     </httpHandlers>
</system.web>

<system.webServer>
     <validation validateIntegratedModeConfiguration="false" />
     <handlers>
          <add type="DevExpress.Web.ASPxUploadProgressHttpHandler, DevExpress.Web.v25.1, Version=25.1.7.0, Culture=neutral, 
          PublicKeyToken=b88d1754d700e49a" verb="GET,POST" path="ASPxUploadProgressHandlerPage.ashx" name="ASPxUploadProgressHandler" preCondition="integratedMode" />
     </handlers>
</system.webServer>