HttpRequest.Files Property

Reference

Definition

Namespace:: System.Web

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets the collection of files uploaded by the client, in multipart MIME format.

public:
 property System::Web::HttpFileCollection ^ Files { System::Web::HttpFileCollection ^ get(); };

public System.Web.HttpFileCollection Files { get; }

member this.Files : System.Web.HttpFileCollection

Public ReadOnly Property Files As HttpFileCollection

Property Value

HttpFileCollection

An HttpFileCollection object representing a collection of files uploaded by the client. The items of the HttpFileCollection object are of type HttpPostedFile.

Examples

The following code example displays the names of all files in the Files collection.

int loop1;
HttpFileCollection Files;

Files = Request.Files; // Load File collection into HttpFileCollection variable.
arr1 = Files.AllKeys;  // This will get names of all files into a string array.
for (loop1 = 0; loop1 < arr1.Length; loop1++)
{
    Response.Write("File: " + Server.HtmlEncode(arr1[loop1]) + "<br />");
    Response.Write("  size = " + Files[loop1].ContentLength + "<br />");
    Response.Write("  content type = " + Files[loop1].ContentType + "<br />");
}

Dim loop1 As Integer
 Dim arr1() As String
 Dim Files As HttpFileCollection
 
 Files = Request.Files ' Load File collection into HttpFileCollection variable.
 arr1 = Files.AllKeys ' This will get names of all files into a string array.
        For loop1 = 0 To arr1.GetUpperBound(0)
            Response.Write("File: " & Server.HtmlEncode(arr1(loop1)) & "<br>")
            Response.Write("  size = " + Files(loop1).ContentLength + "<br />")
            Response.Write("  content type = " + Files(loop1).ContentType + "<br />")
        Next loop1

Remarks

The file collection is populated only when the HTTP request Content-Type value is "multipart/form-data".

Applies to

Product	Versions
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Share via