HttpPostedFile.SaveAs(String) Method

Definition

Namespace:

System.Web

Assembly:

System.Web.dll

Saves the contents of an uploaded file.

public:
 void SaveAs(System::String ^ filename);

public void SaveAs (string filename);

member this.SaveAs : string -> unit

Public Sub SaveAs (filename As String)

Parameters

filename

String

The name of the saved file.

Exceptions

HttpException

The RequireRootedSaveAsPath property of the HttpRuntimeSection object is set to true, but filename is not an absolute path.

Examples

The following code example demonstrates how to save all the files that are uploaded by the client to the C:\TempFiles folder on the Web server's local disk.

String TempFileName;
 HttpFileCollection MyFileCollection = Request.Files;

 for (int Loop1 = 0; Loop1 < MyFileCollection.Count; Loop1++)
 {
    // Create a new file name.
    TempFileName = "C:\\TempFiles\\File_" + Loop1.ToString();
    // Save the file.
    MyFileCollection[Loop1].SaveAs(TempFileName);
 }

Dim Loop1 As Integer
 Dim TempFileName As String
 Dim MyFileCollection As HttpFileCollection = Request.Files
 
 For Loop1 = 0 To MyFileCollection.Count - 1
    ' Create a new file name.
    TempFileName = "C:\TempFiles\File_" & CStr(Loop1)
    ' Save the file.
    MyFileCollection(Loop1).SaveAs(TempFileName)
 Next Loop1

Remarks

The maximum size allowed for a request, which includes uploaded files, is 4 MB, by default. Maximum request size can be specified in the Machine.config or Web.config file in the maxRequestLength attribute of the httpRuntime Element (ASP.NET Settings Schema) element. The maximum request size for a specific page can be specified using the location Element (ASP.NET Settings Schema) element in a Web.config file.