This documentation is archived and is not being maintained.

HtmlInputFile Constructor

Initializes a new instance of the HtmlInputFile class.

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

public HtmlInputFile()

Use this constructor to create and initialize a new instance of the HtmlInputFile class.

The following table shows the initial property value for an instance of HtmlInputFile.


Initial Value


The "file" literal string.

The following code example demonstrates how to create a new instance of the HtmlInputFile class. 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" 
<script runat="server">

  void Button1_Click(object sender, EventArgs e)

    // Get the HtmlInputFile control from the Controls collection  
    // of the PlaceHolder control.
    HtmlInputFile file = (HtmlInputFile)Place.FindControl("File1");

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

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

        file.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() + ".";


  void Page_Load(object sender, EventArgs e)

    // Create a new HtmlInputFile control.
    HtmlInputFile file = new HtmlInputFile();
    file.ID = "File1";

    // Add the control to the Controls collection of the 
    // PlaceHolder control.



<html xmlns="" >
    <title>HtmlInputFile Constructor Example</title>


   <h3>HtmlInputFile Constructor Example</h3>

   <form id="form1" enctype="multipart/form-data" 

      Specify the file to upload:
      <asp:PlaceHolder id="Place" 

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

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

      <input type="button" 
             runat="server" />




Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

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

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0