HttpPostedFile 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
提供对客户端已上载的单独文件的访问。
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) |