caching 的 outputCacheSettings 元素(ASP.NET 设置架构)

指定可以应用于 ASP.NET 应用程序中页的输出缓存配置文件设置。

<outputCacheSettings>
    <outputCacheProfiles>...</outputCacheProfiles>
</outputCacheSettings>

特性和元素

以下几节描述了属性、子元素和父元素。

特性

无。

子元素

元素

说明

outputCacheProfiles

包含可以应用于页以指定 OutputCache 指令的缓存设置组。

父元素

元素

说明

configuration

公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中均需要的根元素。

system.web

指定配置文件中 ASP.NET 配置设置的根元素。 包含各种配置元素,这些配置元素配置 ASP.NET Web 应用程序并控制这些应用程序的行为方式。

caching

为 Web 应用程序配置缓存设置。

备注

默认配置

下面的默认 outputCacheSettings 元素不是在计算机配置文件或根 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

元素信息

配置节处理程序

System.Web.Configuration.OutputCacheSettingsSection

配置成员

SystemWebCachingSectionGroup.OutputCacheSettings

可配置的位置

Machine.config

根级别的 Web.config

应用程序级别的 Web.config

要求

IIS 5.0、5.1 和 6.0

.NET Framework 2.0

Visual Studio 2005

请参见

任务

演练:使用输出缓存增强网站性能

如何:使用位置设置配置特定目录

如何:锁定 ASP.NET 配置设置

参考

system.web 元素(ASP.NET 设置架构)

configuration 元素(常规设置架构)

caching 元素(ASP.NET 设置架构)

caching 的 outputCacheSettings 的 outputCacheProfiles 元素(ASP.NET 设置架构)

System.Configuration

System.Web.Configuration

概念

ASP.NET 缓存概述

ASP.NET 配置文件层次结构和继承

保证 ASP.NET 配置的安全

ASP.NET 配置方案

其他资源

常规配置设置 (ASP.NET)

ASP.NET 配置设置

ASP.NET 网站管理

ASP.NET 配置文件

ASP.NET 配置 API