This documentation is archived and is not being maintained.

FileUpload.FileName Property

Gets the name of a file on a client to upload using the FileUpload control.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

public string FileName { get; }
/** @property */
public String get_FileName ()

public function get FileName () : String

Not applicable.

Property Value

A string that specifies the name of a file on a client to upload using the FileUpload.

Gets the name of a file on a client to upload using the FileUpload control. The file name that the FileName property returns does not include the path to the file on the client.

The following code example demonstrates how to create a FileUpload control that saves files to a path that is specified in code. The FileName property is used to get the name of the file to upload. The SaveAs method is called to save the file to the specified path on the server, using the same name the file has on the client. Note that this example demonstrates the basic syntax for this control, but does not demonstrate all the necessary error checking that should be done prior to saving the file. For a more complete example, see SaveAs.

<%@ Page Language="C#" %>

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

<script runat="server">

  protected void UploadButton_Click(object sender, EventArgs e)
    // Specify the path on the server to
    // save the uploaded file to.
    String savePath = @"c:\temp\uploads\";
    // Before attempting to perform operations
    // on the file, verify that the FileUpload 
    // control contains a file.
    if (FileUpload1.HasFile)
      // Get the name of the file to upload.
      String fileName = FileUpload1.FileName;
      // Append the name of the file to upload to the path.
      savePath += fileName;

      // Call the SaveAs method to save the 
      // uploaded file to the specified path.
      // This example does not perform all
      // the necessary error checking.               
      // If a file with the same name
      // already exists in the specified path,  
      // the uploaded file overwrites it.
      // Notify the user of the name of the file
      // was saved under.
      UploadStatusLabel.Text = "Your file was saved as " + fileName;
      // Notify the user that a file was not uploaded.
      UploadStatusLabel.Text = "You did not specify a file to upload.";


<html xmlns="" >
<head runat="server">
    <title>FileUpload Example</title>
    <form id="form1" runat="server">
       <h4>Select a file to upload:</h4>
       <asp:FileUpload id="FileUpload1"                 
       <br /><br />
       <asp:Button id="UploadButton" 
           Text="Upload file"
       <hr />
       <asp:Label id="UploadStatusLabel"

Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0