scheme Element for httpCompression [IIS Settings Schema]

IIS 7.0

Configures the GNU zip (Gzip) and Deflate compression schemes.

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

Attributes

Attribute

Description

dll

Required string attribute.

Specifies the fully qualified file system path and file name of the compression DLL associated with the compression scheme. The World Wide Web Publishing Service (WWW service) must be restarted before any changes to this attribute take effect.

doDynamicCompression

Optional Boolean attribute.

Specifies whether responses to requests for dynamic content, such as scripts in Active Server Pages (ASP) and ISAPI extensions, are compressed. Because this attribute cannot be inherited, it must be set to true at both the global level (httpCompression) and at the individual scheme level if the name attribute is set to Gzip. If this value is changed at the individual compression scheme level, the WWW service must be restarted before the change takes effect.

The default value is true.

doStaticCompression

Optional Boolean attribute.

Specifies whether IIS compresses responses to requests for static content. Because this attribute cannot be inherited, it must be set to true at both the global level (httpCompression) and the individual scheme level if the name attribute is set to Gzip. If this value is changed at the individual compression scheme level, the WWW service must be restarted before the change takes effect.

NoteNote:
The static compression store needs to be located in a disk partition or remote share formatted with NTFS. If the file store is not NTFS, static compression is disabled. For security reasons, no compressed responses will be served from a FAT cache store.

The default value is true.

dynamicCompressionLevel

Optional integer attribute.

Specifies the compression level for the compression scheme when dynamic content is being compressed. The levels range from 0 (lowest compression level and lowest CPU usage) to 10 (highest compression level and highest CPU usage). 0 means that compression is disabled. The WWW service must be restarted before any changes to this attribute take effect.

NoteNote:
Because dynamic compression consumes considerable CPU time and memory resources, use it only on servers that have slow network connections but CPU time to spare. Compressed static responses can be cached and, therefore, do not affect CPU resources like dynamic responses do.

The default value is 0.

name

Required string attribute.

Specifies the name of the compression scheme, for example, Gzip or Deflate.

staticCompressionLevel

Optional integer attribute.

Specifies the compression level for the compression scheme when static content is being compressed. The levels range from 0 (lowest compression level and lowest CPU usage) to 10 (highest compression level and lowest CPU usage). 0 means that compression is disabled. The WWW service must be restarted before any changes to this attribute take effect.

The default value is 7.

Child Elements

Element

Description

remove

Optional element.

Removes a reference to an HTTP compression scheme from the HTTP compression scheme collection.

clear

Optional element.

Removes all references to HTTP compression schemes from the HTTP compression scheme collection.

Parent Elements

Element

Description

configuration

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

system.webServer

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

httpCompression

Configures HTTP compression settings for a Web server.

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

Configuration locations

Machine.config

ApplicationHost.config

Root level Web.config

Application level Web.config

Virtual or physical directory level Web.config

Requirements

Microsoft Internet Information Services (IIS) version 7.0

Community Additions

ADD
Show: