ASPxUploadProgressHttpHandler

  • 2 min to read

Furthermore, using a general DevExpress ASPxHttpHandlerModule, ASPxUploadControl also makes use of an additional ASPxUploadProgressHttpHandler. This handler is required to correctly process file uploads in the 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 that are automatically initiated by ASPxUploadControl to send an uploaded file packet to the server and to obtain actual information about file upload progress 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 placed onto a form in Design view.

The registration code is given below; you can add it manually if it is required (for instance, when you do not use design-time editing and create ASPxUploadControl programmatically).

Registration for Version 14.2 and newer

  • IIS (classic mode)

    <system.web>
         <httpHandlers>
              <add type="DevExpress.Web.ASPxUploadProgressHttpHandler, DevExpress.Web.v19.2, Version=19.2.5.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.v19.2, Version=19.2.5.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.v19.2, Version=19.2.5.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.