HttpRuntimeSection.EnableKernelOutputCache Property

Definition

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

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

Attributes

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

See also