ASPxUploadProgressHttpHandler

  • 2 minutes to read

The DevExpress ASPxUploadControl uses ASPxUploadProgressHttpHandler in addition to the standard ASPxHttpHandlerModule. This handler is required to correctly process file uploads in advanced upload mode (enabled via the ASPxUploadControl.UploadMode property) 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.

NOTE

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.

ASPxUploadProgressHttpHandler is automatically registered within a web project's Web.Config file when an ASPxUploadControl is added to a form in Design view.

See the registration code below. You can add it manually, if required (e.g., when you do not use design-time editing and create an ASPxUploadControl programmatically).

Registration for v14.2 and Later

  • IIS (classic mode)

    <system.web>
         <httpHandlers>
              <add type="DevExpress.Web.ASPxUploadProgressHttpHandler, DevExpress.Web.v20.2, Version=20.2.4.0, Culture=neutral,
                PublicKeyToken=b88d1754d700e49a" verb="GET,POST" path="ASPxUploadProgressHandlerPage.ashx" validate="false" />
         </httpHandlers>
    </system.web>
    
  • IIS7 (integrated mode)

    <system.web>
         <httpHandlers>
              <add type="DevExpress.Web.ASPxUploadProgressHttpHandler, DevExpress.Web.v20.2, Version=20.2.4.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.v20.2, Version=20.2.4.0, Culture=neutral, 
              PublicKeyToken=b88d1754d700e49a" verb="GET,POST" path="ASPxUploadProgressHandlerPage.ashx" name="ASPxUploadProgressHandler" preCondition="integratedMode" />
         </handlers>
    </system.webServer>
    

Registration for Version 14.1 and older

  • IIS (classic mode)

    <system.web>
         <httpHandlers>
              <add type="DevExpress.Web.ASPxUploadControl.ASPxUploadProgressHttpHandler, DevExpress.Web.v14.1, Version=14.1.6.0, Culture=neutral,
                PublicKeyToken=b88d1754d700e49a" verb="GET,POST" path="ASPxUploadProgressHandlerPage.ashx" validate="false" />
         </httpHandlers>
    </system.web>
    
  • IIS7 (integrated mode)

    <system.web>
         <httpHandlers>
              <add type="DevExpress.Web.ASPxUploadControl.ASPxUploadProgressHttpHandler, DevExpress.Web.v14.1, Version=14.1.6.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.ASPxUploadControl.ASPxUploadProgressHttpHandler, DevExpress.Web.v14.1, Version=14.1.6.0, Culture=neutral, 
              PublicKeyToken=b88d1754d700e49a" verb="GET,POST" path="ASPxUploadProgressHandlerPage.ashx" name="ASPxUploadProgressHandler" preCondition="integratedMode" />
         </handlers>
    </system.webServer>
    
NOTE

If one of the sections where ASPxUploadProgressHttpHandler should be registered contains a configSourse attribute, it will be skipped without writing anything to it. To learn more, refer to the configSource Attribute topic.