Export (0) Print
Expand All
Expand Minimize

UrlCompressionSection Class [IIS 7 and higher]

IIS 7.0

Enables or disables dynamic or static compression.

class UrlCompressionSection : ConfigurationSection

The following table lists the methods exposed by the UrlCompressionSection class.

Name

Description

GetAllowDefinition

(Inherited from ConfigurationSection.)

GetAllowLocation

(Inherited from ConfigurationSection.)

RevertToParent

(Inherited from ConfigurationSection.)

SetAllowDefinition

(Inherited from ConfigurationSection.)

SetAllowLocation

(Inherited from ConfigurationSection.)

The following table lists the properties exposed by the UrlCompressionSection class.

Name

Description

DoDynamicCompression

A read/write boolean value. true if dynamic compression is enabled for URLs; otherwise, false. The default is false.

NoteNote:
Use of dynamic compression may increase processor utilization and reduce the overall performance of the Web server.

DoStaticCompression

A read/write boolean value. true if static compression is enabled for URLs; otherwise, false. The default is true.

DynamicCompressionBeforeCache

A read/write boolean value. true if the currently available response is dynamically compressed before it is put into the output cache; otherwise, false. The default is false. For more information, see the Remarks section.

Location

(Inherited from ConfigurationSection.) A key property.

Path

(Inherited from ConfigurationSection.) A key property.

SectionInformation

(Inherited from ConfigurationSection.)

This class contains no subclasses.

When the DynamicCompressionBeforeCache property is true, IIS dynamically compresses the response the first time a request is made. The compressed response is put into the output cache, and the cached response is sent to the client. Subsequent requests are served from the compressed response in the output cache.

When DynamicCompressionBeforeCache is false, IIS puts the noncompressed response into the output cache. Then, every time that the response is requested, IIS dynamically compresses the cached response as it is sent to the client.

If you set the DynamicCompressionBeforeCache property to true, the CPU will dynamically compress the response only once instead of every time the page is requested. Because dynamic compression is CPU-intensive, a setting of true can reduce the server load and improve site throughput.

NoteNote:

If the DynamicCompressionBeforeCache property is true when the output cache response has been flushed, dynamic compression will not be performed before the response is put into the output cache. However, if the DoDynamicCompression property is true, dynamic compression will still occur after the response has been put into the output cache.

The following example lists the dynamic and static compression settings for all paths and locations on a Web server. An empty Location property in the output indicates that the setting is global.

' Connect to the WMI WebAdministration namespace.
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")

' Get the URL compression section.
Set oUrlCompressionSection = oWebAdmin.ExecQuery( _
    "SELECT * FROM UrlCompressionSection")

' List the dynamic and static compression settings for each location.
For Each vUrlCompressionProperty In oUrlCompressionSection
    WScript.Echo "Location: " & vUrlCompressionProperty.Location
    WScript.Echo "DoDynamicCompression: " & _
        vUrlCompressionProperty.DoDynamicCompression
    WScript.Echo "DoStaticCompression: " & _
        vUrlCompressionProperty.DoStaticCompression
    WScript.Echo
Next

Type

Description

Client

Requires IIS 7 on Windows Vista.

Server

Requires IIS 7 on Windows Server 2008.

Product

IIS 7

MOF file

WebAdministration.mof

Community Additions

ADD
Show:
© 2014 Microsoft