Tab

UploadControlValidationSettings.AllowedContentTypes Property

Obsolete. Gets or sets the allowed content types of the uploaded file.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v20.2.dll

Declaration

[Obsolete("Use the AllowedFileExtensions property instead. Note, it accepts file extensions instead of content types.")]
public string[] AllowedContentTypes { get; set; }
<Obsolete("Use the AllowedFileExtensions property instead. Note, it accepts file extensions instead of content types.")>
Public Property AllowedContentTypes As String()

Property Value

Type Description
String[]

An array of MIME content-type string values that contains the allowed content types.

Remarks

Use the AllowedContentTypes property to allow end-users to only upload files with the specified content types. If the uploaded file's content type is not allowed (it's not listed by the AllowedContentTypes property), the ASPxUploadControl's validation fails and the UploadControlValidationSettings.NotAllowedContentTypeErrorText property's value is displayed within the control's specific error frame. If the ASPxUploadControl validation fails, the FileUploadCompleteEventArgs.IsValid, ASPxUploadControl.IsValid and ASPxClientUploadControlFileUploadCompleteEventArgs.isValid properties are set to false.

NOTE

Members of an array provided by the AllowedContentTypes property are standard MIME types. For a list of possible values, search for MIME in the MSDN Library.

Note that setting just the AllowedContentTypes property is not sufficient to prevent any potentially harmful attack to a web site. Setting the UploadControlValidationSettings.AllowedFileExtensions property as well, is recommended.

See the Allowed File Extensions topic to learn more.

Examples

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>
See Also