HttpPostedFile 类

定义

提供对客户端已上载的单独文件的访问。

public ref class HttpPostedFile sealed
public sealed class HttpPostedFile
type HttpPostedFile = class
Public NotInheritable Class HttpPostedFile
继承
HttpPostedFile

注解

HttpFileCollection 类提供对作为文件集合从客户端上传的所有文件的访问权限。 该 HttpPostedFile 类提供属性和方法,用于获取有关单个文件的信息以及读取和保存文件。

HtmlInputFile 控件可用于从客户端选择和上传文件。

文件以 MIME 多部分/表单数据格式上传。 默认情况下,所有请求(包括表单字段和上传的文件)都缓冲到磁盘,而不是保存在服务器内存中。

可以通过访问MaxRequestLength属性或设置 httpRuntime 元素 (ASP.NET 设置架构) 元素在Machine.config或Web.config文件中设置maxRequestLength属性来指定允许的最大请求大小。 默认值为 4 MB。

请求的服务器内存中缓冲的数据量(包括文件上传)可以通过访问RequestLengthDiskThreshold属性或设置 requestLengthDiskThreshold Machine.config 或 Web.config 文件中的 httpRuntime 元素 (ASP.NET 设置架构) 元素的属性来指定。

通过调整 MaxRequestLength 属性, RequestLengthDiskThreshold 可以微调服务器的性能。 此外,应考虑设置 MaxRequestLength 以防止用户将大型文件发布到服务器导致的拒绝服务攻击。

分配用于缓冲上传的文件的服务器资源将在请求结束时销毁。 若要保存文件的持久副本,请使用 SaveAs 该方法。

属性

ContentLength

获取已上载文件的大小(以字节为单位)。

ContentType

获取客户端发送的文件的 MIME 内容类型。

FileName

获取客户端上文件的完全限定名称。

InputStream

获取一个 Stream 对象,该对象指向一个上载文件,以准备读取该文件的内容。

方法

Equals(Object)

确定指定对象是否等于当前对象。

(继承自 Object)
GetHashCode()

作为默认哈希函数。

(继承自 Object)
GetType()

获取当前实例的 Type

(继承自 Object)
MemberwiseClone()

创建当前 Object 的浅表副本。

(继承自 Object)
SaveAs(String)

保存已上载文件的内容。

ToString()

返回表示当前对象的字符串。

(继承自 Object)

适用于

另请参阅