HttpPostedFile 类

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

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

public ref class HttpPostedFile sealed

public sealed class HttpPostedFile

type HttpPostedFile = class

Public NotInheritable Class 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 对象，该对象指向一个上载文件，以准备读取该文件的内容。