Skip to main content

UploadControlValidationSettings.MaxFileSize Property

Gets or sets the maximum file size (in bytes).

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v23.1.dll

NuGet Package: DevExpress.Web


public virtual long MaxFileSize { get; set; }

Property Value

Type Default Description
Int64 0

An Int64 value which specifies the maximum file size.

Property Paths

You can access this nested property as listed below:

Library Object Type Path to MaxFileSize
ASP.NET Web Forms Controls ASPxUploadControl
.ValidationSettings .MaxFileSize
ASP.NET MVC Extensions UploadControlBinderSettings
.ValidationSettings .MaxFileSize
.ValidationSettings .MaxFileSize


If the uploaded file exceeds the MaxFileSize property’s value, an error text specified by the UploadControlValidationSettings.MaxFileSizeErrorText property is displayed within the ASPxUploadControl‘s specific error frame. The uploaded file’s validation is considered to have failed in this case (this means that the ASPxUploadControl.IsValid, FileUploadCompleteEventArgs.IsValid and ASPxClientUploadControlFileUploadCompleteEventArgs.isValid properties are set to false).


The following sample code demonstrates how to save the file specified within the ASPxUploadControl on the client. Before file saving, the FileUploadCompleteEventArgs.IsValid property is tested to verify whether the file passes the validation criteria defined via the ASPxUploadControl.ValidationSettings property. Note, that in order to compose the ASPxUploadControl.SaveAs method’s parameter value, the HostingEnvironment.MapPath(String) method and ASPxUploadControl.FileName property are used to specify the web application’s Image folder as a location where the file should be saved, and define the file’s name, respectively.

<%@ Page Language="C#" AutoEventWireup="true"  CodeFile="Default.aspx.cs" Inherits="_Default" %>
<%@ Register Assembly="DevExpress.Web.v10.2, Version=, Culture=neutral, 
PublicKeyToken=b88d1754d700e49a" Namespace="DevExpress.Web.ASPxUploadControl" TagPrefix="dxuc" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 

<script runat="server">
protected void Page_Load(object sender, EventArgs e){
protected void ASPxUploadControl1_FileUploadComplete(object sender, 
DevExpress.Web.FileUploadCompleteEventArgs e) {
        if (e.IsValid) {
            ASPxUploadControl1.SaveAs(MapPath("Images/" + ASPxUploadControl1.FileName));

<html xmlns="" >
<head id="Head1" runat="server">
    <title>How to use the ASPxUploadControl's Validation Settings</title>
    <form id="form2" runat="server">
                FileDoesNotExistErrorText="This file can't be found." 
                GeneralErrorText="Custom file uploading fails due to an external error that 
                    doesn't relate to the ASPxUploadControl's functionality" 
                MaxFileSizeErrorText="Size of the uploaded file exceeds maximum file size" 
                NotAllowedContentTypeErrorText="The uploaded file's content type isn't allowed">
                <ErrorStyle BackColor="Yellow" ForeColor="Black" />

See Also