HttpRuntimeSection.EnableKernelOutputCache Property

Reference

Definition

Namespace:: System.Web.Configuration

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets or sets a value that indicates whether output caching is enabled.

public:
 property bool EnableKernelOutputCache { bool get(); void set(bool value); };

[System.Configuration.ConfigurationProperty("enableKernelOutputCache", DefaultValue=true)]
public bool EnableKernelOutputCache { get; set; }

[<System.Configuration.ConfigurationProperty("enableKernelOutputCache", DefaultValue=true)>]
member this.EnableKernelOutputCache : bool with get, set

Public Property EnableKernelOutputCache As Boolean

Property Value

Boolean

true if output caching is enabled; otherwise, false. The default value is true.

Attributes: ConfigurationPropertyAttribute

Examples

The following example shows how to use the EnableKernelOutputCache property.

// Get the current EnableKernelOutputCache property value.
Response.Write("EnableKernelOutputCache: " +
  configSection.EnableKernelOutputCache + "<br>");

// Set the EnableKernelOutputCache property to true.
configSection.EnableKernelOutputCache = true;

' Get the current EnableKernelOutputCache property value.
Response.Write("EnableKernelOutputCache: " & _
  configSection.EnableKernelOutputCache & "<br>")

' Set the EnableKernelOutputCache property to true.
configSection.EnableKernelOutputCache = True

Remarks

In order to cache a response, the following criteria need to be met:

Caching must be explicitly enabled by a page directive or by the caching API.
Caching must have an expiration policy so that the kernel knows when to discard it.
Caching cannot have any variable headers or parameters.
The request must not require any authentication.

Note

This property is relevant only when Internet Information Services (IIS) version 6.0 or later is installed.

Applies to

Jaa