filter Element for isapiFilters [IIS Settings Schema]

Note

For more information about the filter element, see the following topic on the Microsoft IIS.net Web site: Filter <filter>.

Configures an ISAPI filter to process client request data or server response data.

Syntax

Attributes and Elements

The following sections describe attributes, child elements, and parent elements for this section.

Attributes

Attributes

Description

enableCache

Optional Boolean attribute.

Specifies whether HTTP.sys caching is enabled (true) or disabled (false) for filtered server responses.

The default value is false.

enabled

Optional Boolean attribute.

Specifies whether the installed filter is enabled (true) or disabled (false).

The default value is true.

name

Required string attribute.

Specifies the unique name of the ISAPI filter.

path

Required string attribute.

Specifies the full physical path of the ISAPI filter .dll file.

preCondition

Optional string attribute.

Specifies conditions under which the ISAPI filter will run.

The preCondition attribute can be one or more of the following possible values. If you specify more than one value, separate the values with a comma (,).

ValueDescription
bitness32Specify the bitness32 value when the ISAPI filter is a 32-bit .dll file and IIS should load the filter only for worker processes that run in WOW64 mode (32-bit simulation) on a 64-bit operating system.
bitness64Specify the bitness64 value when the ISAPI filter is a 64-bit .dll file and IIS should load the filter only for worker processes that run in 64-bit mode.
integratedModeSpecify the integratedMode value when the ISAPI filter should use the integrated request-processing pipeline to process requests for managed content.
ISAPIModeSpecify the ISAPIMode value when the ISAPI filter should use the ASP.NET ISAPI extension, aspnet_isapi.dll, to process requests for managed content.
runtimeVersionv1.1Specify the runtimeVersionv1.1 value when the ISAPI filter should load only for application pools that are configured to use .NET Framework version 1.1.
runtimeVersionv2.0Specify the runtimeVersionv2.0 value when the ISAPI filter should load only for application pools that are configured to use .NET Framework version 2.0.

Child Elements

None.

Parent Elements

Element

Description

configuration

Specifies the root element in every configuration file that is used by IIS 7.

system.webServer

Specifies the top-level section group (in ApplicationHost.config) in which this element is defined.

isapiFilters

Specifies configuration settings for ISAPI filters on a Web server.

Remarks

For more information about the filter element, see the following topic on the Microsoft IIS.net Web site: Filter <filter>.

Element Information

Configuration locations

Machine.config

ApplicationHost.config

Root application Web.config

Application Web.config

Requirements

Microsoft Internet Information Services (IIS) version 7.0

See Also

Reference

isapiFilters Element [IIS Settings Schema]