HtmlInputFile.PostedFile Property

Gets access to the uploaded file specified by a client.

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

public HttpPostedFile PostedFile { get; }
/** @property */
public HttpPostedFile get_PostedFile ()

public function get PostedFile () : HttpPostedFile

Not applicable.

Property Value

A System.Web.HttpPostedFile that accesses the file to be uploaded.

Browser security restrictions prevent this value from being maintained across multiple requests.

The following code example demonstrates how to use the PostedFile property to initiate the utility that transfers the file to the server. Note that if the size of the uploaded file in bytes exceeds the value of the ContentLength property, the file is not uploaded. 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 = "File 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> 

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, 1.1, 1.0
Show: