Export (0) Print
Expand All

HtmlInputFile.Value Property

Gets the full path of the file on the client's computer.

Namespace:  System.Web.UI.HtmlControls
Assembly:  System.Web (in System.Web.dll)

[BrowsableAttribute(false)]
public override string Value { get; set; }
<asp:HtmlInputFile Value="String" />

Property Value

Type: System.String
The full path of the client's file.

ExceptionCondition
NotSupportedException

An attempt was made to assign a value to this property.

The Value property retrieves the full path of the file on the client's computer (for example "C:\MyFiles\Test.txt"). This is useful when you need to know where the file is stored on the computer submitting the file. This property is also commonly used to determine the original file name. To get the original file name, parse the value of this property.

NoteNote

The Value property is read-only. If you attempt to assign a value to this property, a System.NotSupportedException is thrown.

The following code example demonstrates how to use the Value property to display the full path of the file on the client's computer. For this example to work properly, you need to create a directory called Temp on your computer's drive C.

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void Button1_Click(object Source, EventArgs e)
  {

    // Make sure a file was submitted.
    if (Text1.Value == "")
    {
      Span1.InnerHtml = "Error: You must enter a file name.";
      return;
    }

    // Save the file.
    if (File1.PostedFile.ContentLength > 0)
    {
      try
      {

        File1.PostedFile.SaveAs("c:\\temp\\" + Text1.Value);
        Span1.InnerHtml = "<b>" + File1.Value + "</b>" +
                          " uploaded successfully to <b>c:\\temp\\" +
                          Text1.Value + "</b> on the Web server.";

      }
      catch (Exception exc)
      {

        Span1.InnerHtml = "Error saving file <b>c:\\temp\\" +
                          Text1.Value + "</b><br />" + exc.ToString() + ".";

      }
    }
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>HtmlInputFile Example</title>
  </head>

  <body>

    <h3>HtmlInputFile Example</h3>

    <form id="form1" enctype="multipart/form-data" 
          runat="server">

       Select File to Upload: 
       <input id="File1" 
              type="file" 
              runat="server" />

       <p>
       Save as file name (no path): 
       <input id="Text1" 
              type="text" 
              runat="server" />

       </p>
       <p>
       <span id="Span1" 
             style="font: 8pt verdana;" 
             runat="server" />

       </p>
       <p>
       <input type="button" 
              id="Button1" 
              value="Upload" 
              onserverclick="Button1_Click" 
              runat="server" />

       </p>
    </form>

  </body>
</html>

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft