UploadControlValidationSettings.GeneralErrorText Property
Gets or sets the error text indicating that an external error occurs during the specified file’s uploading.
Namespace: DevExpress.Web
Assembly: DevExpress.Web.v23.1.dll
NuGet Package: DevExpress.Web
Declaration
[DefaultValue("File upload failed due to an external error")]
public string GeneralErrorText { get; set; }
Property Value
Type | Default | Description |
---|---|---|
String | "File upload failed due to an external error" | A String value that specifies the error text. |
Property Paths
You can access this nested property as listed below:
Library | Object Type | Path to GeneralErrorText |
---|---|---|
ASP.NET Web Forms Controls | ASPxUploadControl |
|
ASP.NET MVC Extensions | UploadControlBinderSettings |
|
UploadControlSettings |
|
Example
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=10.2.1.0, Culture=neutral,
PublicKeyToken=b88d1754d700e49a" Namespace="DevExpress.Web.ASPxUploadControl" TagPrefix="dxuc" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<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));
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>How to use the ASPxUploadControl's Validation Settings</title>
</head>
<body>
<form id="form2" runat="server">
<dxuc:ASPxUploadControl
ID="ASPxUploadControl1"
runat="server"
OnFileUploadComplete="ASPxUploadControl1_FileUploadComplete">
<ValidationSettings
AllowedFileExtensions=".txt,.jpg,.jpe,.jpeg,.doc"
MaxFileSize="1000000"
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" />
</ValidationSettings>
</dxuc:ASPxUploadControl>
</form>
</body>
</html>