HtmlInputFile.Value Property

  • Reference

Definition

Namespace:
System.Web.UI.HtmlControls
Assembly:
System.Web.dll

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

public:
 virtual property System::String ^ Value { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Browsable(false)]
public override string Value { get; set; }
[<System.ComponentModel.Browsable(false)>]
member this.Value : string with get, set
Public Overrides Property Value As String

Property Value

String

The full path of the client's file.

Attributes
BrowsableAttribute

Exceptions

NotSupportedException

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

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

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

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.

Note

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

Applies to

See also