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

更新:2007 年 11 月

指定应用程序范围的输出缓存设置。

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

<outputCache enableOutputCache="true|false" 
             enableFragmentCache="true|false" 
             sendCacheControlHeader="true|false" 
             omitVaryStar="true|false">
</outputCache>

属性和元素

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

属性

属性

说明

enableOutputCache

可选的 Boolean 属性。

启用/禁用页输出缓存。

如果禁用,则无论是否具有编程性或声明性设置,都不会缓存页。

默认值为 true。

enableFragmentCache

可选的 Boolean 属性。

启用/禁用应用程序片段缓存。

如果禁用,则无论是否使用 @ OutputCache 指令或缓存配置文件,都不会缓存页。包括一个缓存控件标头,指示上游代理服务器以及浏览器客户端不应尝试缓存页输出。

默认值为 false。

sendCacheControlHeader

可选的 Boolean 属性。

获取或设置一个值,该值指示默认情况下是否由输出缓存模块发送 cache-control:private 标头。

默认值为 false。

omitVaryStar

可选的 Boolean 属性。

允许/禁止在响应中发送 HTTP“Vary: *”标头。默认设置为 False,表示为输出缓存页发送“Vary: *”标头。

默认值为 false。

子元素

无。

父元素

元素

说明

configuration

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

system.web

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

caching

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

备注

默认配置

下面的默认 outputCache 元素不是在计算机配置文件或根 Web.config 文件中显式配置的,而是由 .NET Framework 版本 2.0 中的应用程序返回的默认配置。

<outputCache enableOutputCache = "true" 
             enableFragmentCache = "true" 
             sendCacheControlHeader = "true" 
             omitVaryStar = "false">
</outputCache>

示例

下面的示例禁用 ASP.NET 应用程序的输出缓存。

<outputCache enableOutputCache="false" />

元素信息

配置节处理程序

System.Web.Configuration.OutputCacheSection

配置成员

SystemWebCachingSectionGroup.OutputCache

可配置的位置

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 的 cache 元素(ASP.NET 设置架构)

System.Configuration

System.Web.Configuration

其他资源

常规配置设置 (ASP.NET)

ASP.NET 配置设置

管理 ASP.NET 网站

ASP.NET 配置文件

ASP.NET 配置 API