caching 的 outputCacheSettings 的 outputCacheProfiles 元素（ASP.NET 设置架构）
[本文档仅供预览，在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]
包含缓存设置组，可将这些设置应用于页以指定 @OutputCache 指令。
<outputCacheProfiles>
<add.../>
<clear />
<remove.../>
</outputCacheProfiles>
特性和元素
以下几节描述了特性、子元素和父元素。
特性
无。
子元素
元素 |
说明 |
|---|---|
add |
可选元素。 向配置集合添加一个 OutputCacheProfile 对象。 |
clear |
可选元素。 从配置集合中移除所有 OutputCacheProfile 对象。 |
remove |
可选元素。 从配置集合中移除具有指定名称的 OutputCacheProfile 对象。 |
父元素
元素 |
说明 |
|---|---|
configuration |
公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中均需要的根元素。 |
system.web |
指定配置文件中 ASP.NET 配置设置的根元素。 包含各种配置元素，这些配置元素配置 ASP.NET Web 应用程序并控制这些应用程序的行为方式。 |
caching |
为 Web 应用程序配置缓存设置。 |
outputCacheSettings |
指定可以应用于 ASP.NET 应用程序中页和控件的输出缓存设置。 |
备注
默认配置
下面的默认 outputCacheProfiles 元素不是在计算机配置文件或根 Web.config 文件中显式配置的，而是由 .NET Framework 版本 2.0 中的应用程序返回的默认配置。
<outputCacheSettings>
<outputCacheProfiles>
<add name = ""
enabled = "true"
duration = "-1"
location = ""
sqlDependency = ""
varyByCustom = ""
varyByControl = ""
varyByHeader = ""
varyByParam = ""
noStore = "false"/>
</outputCacheProfiles>
</outputCacheSettings>
<outputCacheSettings>
<outputCacheProfiles>
<clear />
</outputCacheProfiles>
</outputCacheSettings>
示例
下面的示例将某一页在服务器上仅缓存一分钟，并且根据浏览器类型和主版本存储该页的不同版本。
<outputCacheSettings>
<outputCacheProfiles>
<add name="ServerOnly"
duration="60"
varyByCustom="browser"
location="Server" />
</outputCacheProfiles>
</outputCacheSettings>
设计需要以这种方式缓存的页时，您需要向该页添加以下指令：
<%@ OutputCache CacheProfile="ServerOnly" %>
有关更多信息，请参见@ OutputCache。
元素信息
配置节处理程序 |
|
配置成员 |
|
可配置的位置 |
Machine.config 根级别的 Web.config 应用程序级别的 Web.config |
要求 |
IIS 5.0、5.1 和 6.0 .NET Framework 2.0 Visual Studio 2005 |
请参见
任务
How to: Configure Specific Folders Using Location Settings
How to: Lock ASP.NET Configuration Settings
参考
caching 的 outputCacheSettings 元素（ASP.NET 设置架构）
caching 的 outputCacheProfiles 的 add 元素（ASP.NET 设置架构）
caching 的 outputCacheProfiles 的 clear 元素（ASP.NET 设置架构）
caching 的 outputCacheProfiles 的 remove 元素（ASP.NET 设置架构）
概念
ASP.NET Configuration File Hierarchy