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 .gif)
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