Use the Add Cache Rule or Edit Cache Rule dialog box to configure how IIS caches content for a specific file name extension. You can configure settings for both user-mode and kernel-mode caching.

UI Element List

Element Name Description

File name extension

Specifies the file name extension (such as .aspx) to which the caching rule applies. To apply the rule to all file name extensions, type an asterisk (*) in the box.

User-mode caching

Configures the rule to store content in the output cache, which is in user mode. Select an option under File Cache Monitoring to configure how or when the output cache is updated for any files that are cached because of this rule.

Using file change notifications (under the User-mode caching option)

Configures the files (that are cached because of this rule) to be removed from the output cache when IIS receives a file or configuration change notification.

At time intervals (hh:mm:ss) (under the User-mode caching option)

Configures the files (that are cached because of this rule) to be removed from the output cache after a specific duration unless a file or configuration change notification clears the cache before the duration elapses.

The value in the corresponding box specifies the length of time that content is stored in the output cache. The time is formatted as hh:mm:ss (where hh is hours, mm is minutes, and ss is seconds). The default duration is 30 seconds. Setting the value too low may affect server performance by forcing items to be updated more frequently than necessary.

Note

When you select both user-mode caching and kernel-mode caching, and configure each mode to use the At time intervals (hh:mm:ss) option, you must specify the same duration value for both modes. If the values are not the same, the duration that is specified for kernel-mode caching will be used.

Prevent all caching

Configures the files (that match the file name extension) not to be stored in the output cache.

This setting corresponds to the DisableCache setting in configuration, and differs from the DontCache setting that appears in configuration when you do not select the User-mode caching option in IIS Manager. The DontCache setting means that the output cache module does not set the user-mode caching policy, but if another module sets the caching policy, the output cache module will cache the response. The DisableCache setting means that the output cache will not cache the response even when another module tries to enable user-mode caching by setting the user-mode caching policy.

Advanced

Opens the Advanced Output Caching Settings dialog box in which you can configure the cache rule to cache different versions of a response based on query strings and headers. These options are available only for user-mode caching.

Kernel-mode caching

Configures the rule to store content in the kernel cache, which is in kernel mode. Select an option under File Cache Monitoring to configure how or when the kernel cache is updated for any files that are cached because of this rule.

Using file change notifications (under the Kernel-mode caching option)

Configures the files (that are cached because of this rule) to be removed from the kernel cache when IIS receives a file or configuration change notification.

At time intervals (hh:mm:ss) notifications (under the Kernel-mode caching option)

Configures the files (that are cached because of this rule) to be removed from the kernel cache after a specified time elapses.

The value in the corresponding box specifies the length of time that content is stored in the kernel cache. The time is formatted as hh:mm:ss (where hh is hours, mm is minutes, and ss is seconds). The default duration is 30 seconds. Setting the value too low may affect server performance by forcing items to be updated more frequently than necessary.

Note

When you select both user-mode caching and kernel-mode caching, and configure each mode to use the At time intervals (hh:mm:ss) option, you must specify the same duration value for both modes. If the values are not the same, the duration that is specified for kernel-mode caching will be used.

Prevent all caching notifications (under the Kernel-mode caching option)

Configures the files (that match the file name extension) not to be stored in the kernel cache.

This setting corresponds to the DisableCache setting in configuration, and differs from the DontCache setting that appears in configuration when you do not select the Kernel-mode caching option in IIS Manager. The DontCache setting means that the output cache module does not set the kernel-mode caching policy, but if another module sets the caching policy, the output cache module will cache the response. The DisableCache setting means that the kernel cache will not cache the response even when another module tries to enable kernel-mode caching by setting the kernel-mode caching policy.

See Also