Skip to main content
A newer version of this page is available. .
Tab

ASPxUploadControl.ShowProgressPanel Property

Specifies the progress panel visibility.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v20.2.dll

NuGet Package: DevExpress.Web

Declaration

[DefaultValue(false)]
public bool ShowProgressPanel { get; set; }

Property Value

Type Default Description
Boolean **false**

true, if the progress panel is visible; otherwise, false.

Remarks

Use the ShowProgressPanel property to specify whether the progress panel (which contains the progress bar and cancel button) is visible within the ASPxUploadControl.

The appearance of the progress bar element and the cancel button are customized by using the ASPxUploadControl.ProgressBarStyle, ASPxUploadControl.ProgressBarIndicatorStyle and the ASPxUploadControl.ButtonStyle properties. The image and text for the cancel button are defined via the ASPxUploadControl.CancelButton property. The cancel button‘s layout can be customized using the ASPxUploadControl.CancelButtonHorizontalPosition and ASPxUploadControl.CancelButtonSpacing properties.

Note

The ASPxUploadProgressHttpHandler is required for the ASPxUploadControl‘s progress panel to function properly. This handler is automatically added to a web project’s Web.Config file when setting the ShowProgressPanel property to true within the ASPxUploadControl‘s smart tag. If you enable the ShowProgressPanel property via code, you should manually register the ASPxUploadProgressHttpHandler within the Web.Config file.

Note

If you are experiencing the “Access is denied” or “Permission Denied” error during large file uploads to the IIS 5.x or Cassini Web Server, we recommend that you execute the following command at the server, to work around the problem:

%windir%\system32\inetsrv\appcmd.exe set config -section:system.webServer/security/requestFiltering -requestLimits.maxAllowedContentLength:<new-request-length>

Here, <new-request-length> is the new, larger value of the request length.

Note

The maximum size of the file that can be uploaded using ASPxUploadControl in the standard upload mode with progress enabled is about 633MB. To learn more, see the Uploading Large Files topic.

Example

This sample demonstrates how to use the ASPxUploadControl, and how to pass a file name that was saved on the server to the client, by using the server-side and client-side FileUploadComplete events.

     function OnUploadStart() {
         btnUpload.SetText("Uploading...");
         btnUpload.SetEnabled(false);
     }
     function OnUploadComplete(args) {
         btnUpload.SetText("Upload");
         btnUpload.SetEnabled(true);
         lblFileName.SetText(args.callbackData);
     }
See Also