ASPxUploadProgressHttpHandler

  • 2 minutes to read

The DevExpress MVC UploadControl extension uses ASPxUploadProgressHttpHandler in addition to the standard ASPxHttpHandlerModule. This handler is required to correctly process file uploads in advanced upload mode (enabled via the UploadControlSettings.UploadMode property) and to support upload progress indication (enabled via the UploadControlSettings.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 you add UploadControl to a page using the Insert DevExpress MVC Extension Wizard or create an application via the Template Gallery.

See the registration code below. You can add it manually, if required (e.g., when you create an UploadControl programmatically).

  • IIS (classic mode)

    <system.web>
         <httpHandlers>
              <add type="DevExpress.Web.ASPxUploadProgressHttpHandler, DevExpress.Web.v21.1, Version=21.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.ASPxUploadProgressHttpHandler, DevExpress.Web.v21.1, Version=21.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.ASPxUploadProgressHttpHandler, DevExpress.Web.v21.1, Version=21.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.