HtmlInputFile.PostedFile Property

.NET Framework Class Library

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

Property Value

Remarks

Example

Requirements

See Also