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