UploadedFile.FileName Property

Gets the uploaded file’s name.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v18.2.dll

Declaration

C#

public string FileName { get; }

VB.NET

Public ReadOnly Property FileName As String

Property Value

Type	Description
String	A String value specifying the file name.

Remarks

You can use this property’s value to compose the UploadedFile.SaveAs method’s parameter value.

Note

The FileName property contains the name of the uploaded file, but does not store the path to the file.

Example

The following part of the ASPxUploadControl Multi-File Upload online demo illustrates the ASPxUploadControl’s capability to upload more than one file at a time.

JS

var fieldSeparator = "|";
function FileUploadStart() {
    document.getElementById("uploadedListFiles").innerHTML = "";
}
function FileUploaded(s, e) {
    if(e.isValid) {
        var linkFile = document.createElement("a");
        var indexSeparator = e.callbackData.indexOf(fieldSeparator);
        var fileName = e.callbackData.substring(0, indexSeparator);
        var pictureUrl = e.callbackData.substring(indexSeparator + fieldSeparator.length);
        var date = new Date();
        var imgSrc = "UploadImages/" + pictureUrl + "?dx=" + date.getTime();
        linkFile.innerHTML = fileName;
        linkFile.setAttribute("href", imgSrc);
        linkFile.setAttribute("target", "_blank");
        var container = document.getElementById("uploadedListFiles");
        container.appendChild(linkFile);
        container.appendChild(document.createElement("br"));
    }
}

ASPX

<script runat="server">
 public partial class UploadControl_MultiFileUpload : BasePage
 {
     const string UploadDirectory = "~/UploadControl/UploadImages/";
     const int ThumbnailSize = 100;

     protected void Page_Load(object sender, EventArgs e) {
         if(IsPostBack)
             UploadControl.ShowProgressPanel = chbShowProgressPanel.Checked;
     }

     protected string SavePostedFiles(UploadedFile uploadedFile) {
         string ret = "";
         if(uploadedFile.IsValid) {
             FileInfo fileInfo = new FileInfo(uploadedFile.FileName);
             string resFileName = MapPath(UploadDirectory) + fileInfo.Name;
             uploadedFile.SaveAs(resFileName);

             string fileLabel = fileInfo.Name;
             string fileType = uploadedFile.PostedFile.ContentType.ToString();
             string fileLength = uploadedFile.PostedFile.ContentLength / 1024 + "K";
             ret = string.Format("{0} <i>({1})</i> {2}|{3}", 
                 fileLabel, fileType, fileLength, fileInfo.Name);
         }
         return ret;
     }
     protected void UploadControl_FileUploadComplete(object sender, 
      FileUploadCompleteEventArgs e) {
         try {
             e.CallbackData = SavePostedFiles(e.UploadedFile);
         }
         catch(Exception ex) {
             e.IsValid = false;
             e.ErrorText = ex.Message;
         }
     }
 }
</script>
...
         <dxuc:ASPxUploadControl ID="UploadControl" runat="server" 
             ShowAddRemoveButtons="True" Width="300px"
             ShowUploadButton="True" AddUploadButtonsHorizontalPosition="Left" 
             ShowProgressPanel="True" ClientInstanceName="UploadControl" 
             OnFileUploadComplete="UploadControl_FileUploadComplete" FileInputCount="3">
             <ValidationSettings MaxFileSize="4000000" 
             AllowedFileExtensions=".jpg,.jpe,.jpeg,.gif"></ValidationSettings>
             <ClientSideEvents
                 fileuploadcomplete="function(s, e) { FileUploaded(s, e) }"
                 fileuploadstart="function(s, e) { FileUploadStart(); }"
             />
         </dxuc:ASPxUploadControl>
...
         <dxrp:ASPxRoundPanel ID="ASPxRoundPanel1" runat="server" Width="300px" 
             ClientInstanceName="RoundPanel"
             HeaderText="Uploaded files (jpeg, gif)" Height="100%">
             <panelcollection>
                 <dxp:PanelContent runat="server">
                     <div id="uploadedListFiles" style="height: 150px; font-family: Arial;">
                     </div>
                 </dxp:PanelContent>
             </panelcollection>
         </dxrp:ASPxRoundPanel>
...

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the FileName property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

uploadcontrol-an-example-of-use-t227032/CS/UploadControlExample/Controllers/HomeController.cs#L31

for (int i = 0; i < files.Length; i++) {
    if (files[i].IsValid && !string.IsNullOrWhiteSpace(files[i].FileName)) {
        string resultFilePath = "~/Content/" + files[i].FileName;

how-to-use-aspxuploadcontrol-in-the-edit-appointment-form-t182668/CS/WebApplication1/CustomControls/CustomAppointmentForm.ascx.cs#L50

FileInfo fileInfo = new FileInfo(uploadedFile.FileName);
string resFileName = MapPath(UploadDirectory) + fileInfo.Name;

how-to-use-aspxuploadcontrol-in-a-custom-appointment-form-to-upload-and-save-a-file-conten-t213111/CS/WebApplication1/CustomControls/CustomAppointmentForm.ascx.cs#L33

Session["AppointmentAttachment"] = e.UploadedFile.FileBytes;
Session["AppointmentAttachmentFileName"] = e.UploadedFile.FileName;

gridview-how-to-upload-an-excel-file-via-uploadcontrol-and-display-its-data-in-a-grid-t449148/CS/T449148/Controllers/HomeController.cs#L53

MemoryStream ms = new MemoryStream();
string resultExtension = Path.GetExtension(e.UploadedFile.FileName);
string resultFileName = Path.ChangeExtension(Path.GetRandomFileName(), resultExtension);

richedit-how-to-upload-a-file-via-uploadcontrol-and-open-it-in-richedit-t530023/CS/T530023/Controllers/HomeController.cs#L38

for (int i = 0; i < files.Length; i++) {
    if (files[i].IsValid && !string.IsNullOrWhiteSpace(files[i].FileName)) {
        string resultFilePath = "~/Content/" + files[i].FileName;

VB.NET

uploadcontrol-an-example-of-use-t227032/VB/UploadControlExample/Controllers/HomeController.vb#L33

For i As Integer = 0 To files.Length - 1
    If files(i).IsValid AndAlso (Not String.IsNullOrWhiteSpace(files(i).FileName)) Then
        Dim resultFilePath As String = "~/Content/" & files(i).FileName

how-to-use-aspxuploadcontrol-in-the-edit-appointment-form-t182668/VB/WebApplication1/CustomControls/CustomAppointmentForm.ascx.vb#L54

Dim fileInfo As New FileInfo(uploadedFile.FileName)
Dim resFileName As String = MapPath(UploadDirectory) & fileInfo.Name

how-to-use-aspxuploadcontrol-in-a-custom-appointment-form-to-upload-and-save-a-file-conten-t213111/VB/WebApplication1/CustomControls/CustomAppointmentForm.ascx.vb#L35

Session("AppointmentAttachment") = e.UploadedFile.FileBytes
Session("AppointmentAttachmentFileName") = e.UploadedFile.FileName

gridview-how-to-upload-an-excel-file-via-uploadcontrol-and-display-its-data-in-a-grid-t449148/VB/T449148_VB/Controllers/HomeController.vb#L40

Dim ms As MemoryStream = New MemoryStream()
Dim resultExtension As String = Path.GetExtension(e.UploadedFile.FileName)
Dim resultFileName As String = Path.ChangeExtension(Path.GetRandomFileName(), resultExtension)

richedit-how-to-upload-a-file-via-uploadcontrol-and-open-it-in-richedit-t530023/VB/T530023_VB/Controllers/HomeController.vb#L28

For i As Integer = 0 To files.Length - 1
    If files(i).IsValid AndAlso Not String.IsNullOrWhiteSpace(files(i).FileName) Then
        Dim resultFilePath As String = "~/Content/" + files(i).FileName