Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

HtmlInputFile.PostedFile Property

Gets access to the uploaded file specified by a client.

[Visual Basic]
Public ReadOnly Property PostedFile As HttpPostedFile
[C#]
public HttpPostedFile PostedFile {get;}
[C++]
public: __property HttpPostedFile* get_PostedFile();
[JScript]
public function get PostedFile() : HttpPostedFile;

Property Value

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

Remarks

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

Example

[Visual Basic, C#, JScript] The following example demonstrates how to use the PostedFile property to initiate the utility that transfers the file to the server.

[Visual Basic] 
<%@ Page Language="VB" AutoEventWireup="True" %>

<html>
 <head>
 
    <script language="VB" runat="server">
    Sub Button1_Click(Source As Object, e As EventArgs)
        
        If Text1.Value = "" Then
            Span1.InnerHtml = "Error: you must enter a file name"
            Return
        End If
        
        If Not (File1.PostedFile Is Nothing) Then
            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 exc As Exception
                Span1.InnerHtml = "Error saving file <b>c:\temp\" & _ 
                                      Text1.Value & "</b><br>" & exc.ToString()
            End Try
        End If
    End Sub 'Button1_Click
 
  </script>
 
 </head>
 <body>
 
    <h3>HtmlInputFile Sample</h3>
 
    <form enctype="multipart/form-data" runat="server">
 
       Select File to Upload: 
       <input id="File1" 
              type="file"
              maxlength="30"
              runat="server"/>
 
       <p/>
       Save as filename (no path): 
       <input id="Text1" 
              type="text" 
              runat="server"/>
 
       <p/>
       <span id="Span1" 
             style="font: 8pt verdana;" 
             runat="server" />
 
       <p/>
       <input type="button" 
              id="Button1" 
              value="Upload" 
              OnServerClick="Button1_Click" 
              runat="server">
 
    </form>
 
 </body>
 </html>
 

[C#] 
<%@ Page Language="C#" AutoEventWireup="True" %>

<html>
 <head>
 
    <script language="C#" runat="server">
 
       void Button1_Click(object Source, EventArgs e) 
       {
 
          if (Text1.Value == "") 
          {
             Span1.InnerHtml = "Error: you must enter a file name";
             return;
          }
 
          if (File1.PostedFile != null) 
          {
             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>
 
 </head>
 <body>
 
    <h3>HtmlInputFile Sample</h3>
 
    <form enctype="multipart/form-data" runat="server">
 
       Select File to Upload: 
       <input id="File1" 
              type="file"
              maxlength="30"
              runat="server"/>
 
       <p/>
       Save as filename (no path): 
       <input id="Text1" 
              type="text" 
              runat="server"/>
 
       <p/>
       <span id="Span1" 
             style="font: 8pt verdana;" 
             runat="server" />
 
       <p/>
       <input type="button" 
              id="Button1" 
              value="Upload" 
              OnServerClick="Button1_Click" 
              runat="server">
 
    </form>
 
 </body>
 </html>
 

[JScript] 
<%@ Page Language="JScript" AutoEventWireup="True" %>

<html>
 <head>
 
    <script language="JSCRIPT" runat="server">
    function Button1_Click(source : Object, e : EventArgs){
        
        if(Text1.Value == ""){
            Span1.InnerHtml = "Error: you must enter a file name"
            return
        }
        
        if(File1.PostedFile != null){
            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(exc : Exception){
                Span1.InnerHtml = "Error saving file <b>c:\\temp\\"
                                + Text1.Value + "</b><br>" + exc.ToString()
            }
        }
    }
 
  </script>
 
 </head>
 <body>
 
    <h3>HtmlInputFile Sample</h3>
 
    <form enctype="multipart/form-data" runat="server">
 
       Select File to Upload: 
       <input id="File1" 
              type="file"
              maxlength="30"
              runat="server"/>
 
       <p/>
       Save as filename (no path): 
       <input id="Text1" 
              type="text" 
              runat="server"/>
 
       <p/>
       <span id="Span1" 
             style="font: 8pt verdana;" 
             runat="server" />
 
       <p/>
       <input type="button" 
              id="Button1" 
              value="Upload" 
              OnServerClick="Button1_Click" 
              runat="server">
 
    </form>
 
 </body>
 </html>
 

[C++] No example is available for C++. To view a Visual Basic, C#, or JScript example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

HtmlInputFile Class | HtmlInputFile Members | System.Web.UI.HtmlControls Namespace | HttpPostedFile

Show:
© 2015 Microsoft