OutputCacheProfile 类

为 Web 应用程序的页配置输出缓存配置文件。

语法

class OutputCacheProfile : CollectionElement  

方法

此类不包含任何方法。

属性

下表列出了 OutputCacheProfile 类公开的属性。

名称	描述
Duration	一个读/写 sint32 值，指定缓存页面或用户控件的时间（以秒为单位）。 默认值为 -1。 在页面或用户控件上设置此属性将为来自页面或用户控件的 HTTP 响应建立过期策略，并自动缓存页面或用户控件输出。 注意：必须在配置文件或使用该配置文件的页的 @ OutputCache 指令中定义此属性。
Enabled	一个读/写 boolean 值。 如果为使用此输出缓存配置文件的所有页面或控件启用了缓存，则为 true；否则为 false。 默认为 true。
Location	一个读/写 sint32 值，指定缓存位置。 后文的“注解”部分列出了可能的值。
Name	一个只读 string 值，指定输出缓存配置文件名称。
NoStore	一个读/写 boolean 值。 如果页面在 HTTP 响应中发出指示浏览器不要缓存该页面的 true 标头，则为 Cache-Control: Private no-store；否则为 false。 默认为 false。 注意：将此属性设置为 true 等效于在 Web 请求期间调用 System.Web.HttpCachePolicy.SetNoStore 方法。
SqlDependency	一个读/写 string 值，标识页或控件的输出缓存所依赖的一组 SQL 数据库和表名对。 为此属性指定字符串时，只要输出缓存页依赖的 SQL 表发生变化，就可以从缓存中移除输出缓存页。
VaryByControl	一个读/写 string 值，指定要缓存的控件的 ID 集合（以逗号分隔）。 注意：此属性的设置与 @ OutputCache 指令的 VaryByControls 属性的设置相同。
VaryByCustom	一个逗号分隔的读/写 string 值，表示自定义输出缓存要求。 如果为此属性提供的值为“browser”，则缓存因浏览器名称和主要版本信息而异。 如果输入自定义字符串，则必须覆盖你的应用程序的 Global.asax 文件中的 GetVaryByCustomString 方法。 注意：此属性的设置与 @ OutputCache 指令的 VaryByCustom 属性的设置相同。
VaryByHeader	一个读/写 string 值，指定与请求关联的 HTTP 标头集（以逗号分隔），这些标头用于改变缓存的输出。 注意：此属性的设置与 @ OutputCache 指令的 VaryByHeader 属性的设置相同。
VaryByParam	一个 string 值，该值指定参数集（以逗号分隔），这些参数会根据 GET 查询字符串或表单 POST 参数而改变缓存输出。 注意：此属性的设置与 @ OutputCache 指令的 VaryByParam 属性的设置相同。

子类

此类不包含子类。

注解

此类的实例包含在 OutputCacheProfileSettings 类的 OutputCacheProfiles 数组属性中。

下表列出了 Location 属性的可能值。

值	关键字	说明
0	Any	会在服务器、所有兼容 HTTP 1.1 的代理和客户端上缓存页。 此值对应于 System.Web.HttpCacheability.Public 枚举值。
1	Client	仅在发起请求的客户端上缓存页。 此值对应于 System.Web.HttpCacheability.Private 枚举值。
2	Downstream	会在任何支持 HTTP 1.1 的设备上缓存此页，但发起服务器除外。 支持缓存的设备包括代理服务器和发出请求的客户端。
3	Server	仅在处理请求的 Web 服务器上缓存页。 此值对应于 System.Web.HttpCacheability.Server 枚举值。
4	None	不缓存页。 此值对应于 System.Web.HttpCacheability.NoCache 枚举值。
5	ServerAndClient	仅在发起服务器或请求客户端上缓存页。 代理服务器不能缓存响应。 此值对应于 System.Web.HttpCacheability.Private 和 System.Web.HttpCacheability.Server 枚举值的组合。

继承层次结构

CollectionElement

OutputCacheProfile

要求

类型	描述
客户端	- IIS 7.0（在 Windows Vista 上） - Windows 7 上的 IIS 7.5 - Windows 8 上的 IIS 8.0 - Windows 10 上的 IIS 10.0
服务器	- Windows Server 2008 上的 IIS 7.0 - Windows Server 2008 R2 上的 IIS 7.5 - Windows Server 2012 上的 IIS 8.0 - Windows Server 2012 R2 上的 IIS 8.5 - Windows Server 2016 上的 IIS 10.0
产品	- IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0
MOF 文件	WebAdministration.mof

另请参阅

System.Web.HttpCachePolicy.SetNoStoreSystem.Web.HttpCacheabilitySystem.Web.UI.OutputCacheLocation
CollectionElement 类
OutputCacheSection 类
OutputCacheSettingsSection 类
OutputCacheProfileSettings 类
SqlCacheDependencySection 类
@ OutputCache
缓存多个版本的用户控件输出