HttpPostedFile 类

定义

命名空间:

System.Web

程序集:

System.Web.dll

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

public ref class HttpPostedFile sealed

public sealed class HttpPostedFile

type HttpPostedFile = class

Public NotInheritable Class HttpPostedFile

继承

Object

HttpPostedFile

注解

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

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

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

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

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

通过调整 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)

另请参阅

• HtmlInputFile
• HttpFileCollection