HttpRuntimeSection.EnableKernelOutputCache Property

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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

Namespace:   System.Web.Configuration
Assembly:  System.Web (in System.Web.dll)

<ConfigurationPropertyAttribute("enableKernelOutputCache", DefaultValue := True)>
Public Property EnableKernelOutputCache As Boolean

Property Value

Type: System.Boolean

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

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.

System_CAPS_noteNote

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

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

.NET Framework
Available since 2.0
Return to top
Show: