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

更新:2007 年 11 月

包含缓存设置组,可将这些设置应用于页以指定 @OutputCache 指令。

configuration 元素(常规设置架构)
  system.web 元素(ASP.NET 设置架构)
    caching 元素(ASP.NET 设置架构)
      caching 的 outputCacheSettings 元素(ASP.NET 设置架构)
        caching 的 outputCacheSettings 的 outputCacheProfiles 元素(ASP.NET 设置架构)

<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

元素信息

配置节处理程序

System.Web.Configuration.OutputCacheSettingsSection

配置成员

OutputCacheSettingsSection.OutputCacheProfiles

可配置的位置

Machine.config

根级别的 Web.config

应用程序级别的 Web.config

要求

IIS 5.0、5.1 和 6.0

.NET Framework 2.0

Visual Studio 2005

请参见

任务

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

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

概念

ASP.NET 缓存概述

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

保证 ASP.NET 配置的安全

ASP.NET 配置方案

参考

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

configuration 元素(常规设置架构)

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

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

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

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

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

System.Configuration

System.Web.Configuration

其他资源

常规配置设置 (ASP.NET)

ASP.NET 配置设置

管理 ASP.NET 网站

ASP.NET 配置文件

ASP.NET 配置 API