Skip to main content
.NET Framework Class Library
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)
Syntax
<BrowsableAttribute(False)> _
Public Overrides Property Value As String
	Get
	Set
[BrowsableAttribute(false)]
public override string Value { get; set; }
[BrowsableAttribute(false)]
public:
virtual property String^ Value {
	String^ get () override;
	void set (String^ value) override;
}
[<BrowsableAttribute(false)>]
abstract Value : string with get, set
[<BrowsableAttribute(false)>]
override Value : string with get, set
<asp:HtmlInputFile Value="String" />

Property Value

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

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

Remarks

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.

Examples

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="VB" 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">

  Public Sub Button1_Click(ByVal Source As Object, ByVal e As EventArgs)

    ' Make sure a file was submitted.
    If Text1.Value = "" Then

      Span1.InnerHtml = "Error: You must enter a file name."
      Return

    End If

    ' Save the file.
    If File1.PostedFile.ContentLength > 0 Then

      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 exc As Exception

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

      End Try

    End If

  End Sub

</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>


<%@ 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>

Version Information

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1
Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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