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 Overrides Property Value As String

Property Value

Type: System.String

The full path of the client's file.

Exception Condition
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.

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

.NET Framework
Available since 1.1
Return to top
Show: