HttpCompressionSection 类

项目
03/25/2024

配置 HTTP 压缩。

语法

class HttpCompressionSection : ConfigurationSectionWithCollection

方法

下表列出了 HttpCompressionSection 类公开的方法。

名称	说明
添加	（继承自 ConfigurationSectionWithCollection。）
清除	（从 `ConfigurationSectionWithCollection` 继承。）
Get	（从 `ConfigurationSectionWithCollection` 继承。）
GetAllowDefinition	（继承自 ConfigurationSection。）
GetAllowLocation	（从 `ConfigurationSection` 继承。）
删除	（从 `ConfigurationSectionWithCollection` 继承。）
RevertToParent	（从 `ConfigurationSection` 继承。）
SetAllowDefinition	（从 `ConfigurationSection` 继承。）
SetAllowLocation	（从 `ConfigurationSection` 继承。）

属性

下表列出了 HttpCompressionSection 类公开的属性。

名称	描述
`CacheControlHeader`	一个读/写 `string` 值，指定随着压缩文件一起发送的 `Cache-Control` 标头。默认值为“max-age=86400”。若要启用此设置，必须将 `SendCacheHeaders` 属性设置为 `true`。您必须重启 World Wide Web 发布服务（WWW 服务），对 `CacheControlHeader` 属性的更改才会生效。注意：`Cache-Control` 标头随着 `ExpiresHeader` 属性中指定的 `HTTP Expires` 标头一起发送。此标头组合可确保较旧的客户端和代理服务器不会尝试缓存压缩的文件。
`Directory`	读/写 `string` 值，用于指定临时存储和缓存的压缩版本静态文件的目录。默认值是“%SystemDrive%\inetpub\temp\IIS Temporary Compressed Files”。 IIS 7 在此文件夹中为每个应用程序池创建一个子文件夹，并在每个应用程序池文件夹中为每个压缩方案创建一个子文件夹。注意：IIS 6.0 中 IIS 临时压缩文件的默认目录路径为 %Windir%\\IIS Temporary Compressed Files，并且使用了平面目录结构。
`DoDiskSpaceLimiting`	一个读/写 `boolean` 值。如果压缩文件夹中的压缩文件可以占用的磁盘空间量存在限制，则为 `true`；否则为 `false`。默认为 `true`。压缩文件夹由 `Directory` 属性指定。
`DynamicCompressionDisableCpuUsage`	一个读/写 `uint32` 值，指定将禁用动态压缩的 CPU 使用率百分比。默认值为 90。该值必须介于 0 和 100 之间。每 30 秒计算一次 CPU 使用率平均值。注意：此属性充当关闭动态压缩的 CPU 上限。当 CPU 使用率低于 `DynamicCompressionEnableCpuUsage` 属性中指定的值时，将重新启用动态压缩。
`DynamicCompressionEnableCpuUsage`	一个读/写 `uint32` 值，指定将禁用动态压缩的 CPU 使用率百分比。默认值为 50。该值必须介于 0 和 100 之间。每 30 秒计算一次 CPU 使用率平均值。注意：此属性充当关闭动态压缩的 CPU 下限。当 CPU 使用率高于 `DynamicCompressionDisableCpuUsage` 属性中指定的值时，将禁用动态压缩。
`DynamicTypes`	DynamicTypeSettings 值，包含 IIS 可以提供动态压缩的文件扩展名。
`ExpiresHeader`	一个读/写 `string` 值，指定随着压缩文件一起发送的 `HTTP Expires` 标头的内容。默认值为“Wed, 01 Jan 1997 12:00:00 GMT”。若要启用此设置，必须将 `SendCacheHeaders` 属性设置为 `true`。必须重启 WWW 服务，对 `ExpiresHeader` 属性的更改才会生效。注意：`HTTP Expires` 标头随着 `CacheControlHeader` 属性中指定的 `Cache-Control` 标头一起发送。此标头组合可确保较旧的客户端和代理服务器不会尝试缓存压缩的文件。
`HttpCompression`	HttpCompressionSchemeElement 值的数组，指定 IIS 用于压缩客户端请求的压缩方案（Gzip 或 Deflate）。
`Location`	（继承自 `ConfigurationSection`。）一个键属性。
`MaxDiskSpaceUsage`	一个读/写 `uint32` 值，指定压缩文件可以在压缩目录中占用的磁盘空间限制（以兆字节为单位）。默认值为 100。当压缩文件使用的空间超过 `MaxDiskSpaceUsage` 值的 90% 时，IIS 会删除最近使用的文件，直到达到 90% 的使用级别。注意：在 IIS 6.0 中，此限制以字节表示；在 IIS 7 中，以兆字节表示。在 IIS 7 中，针对每个应用程序池应用一个限制。
`MinFileSizeForComp`	一个读/写 `uint32` 值，指定要压缩的文件的最小文件大小（以 KB 为单位）。默认值为 256。
`NoCompressionForHttp10`	一个读/写 `boolean` 值。如果对包含 HTTP 1.0 版本号的请求禁用压缩，则为 `true`；否则为 `false`。默认为 `true`。注意：某些 HTTP 1.0 客户端无法正确处理压缩对象的缓存。可以使用此设置来避免将压缩文件返回到无法进行解压缩的客户端。
`NoCompressionForProxies`	一个读/写 `boolean` 值。如果对通过代理服务器发出的 HTTP 1.1 请求禁用压缩，则为 `true`；否则为 `false`。默认值为`true.`注意：某些 HTTP 代理服务器无法正确处理压缩对象的缓存。可以使用此设置来避免将压缩文件返回到无法进行解压缩的客户端。
`NoCompressionForRange`	一个读/写 `boolean` 值。如果对包含 `Range` 标头的 HTTP 请求禁用压缩，则为 `true`；否则为 `false`。默认为 `true`。注意：某些客户端无法正确处理范围请求。可以使用此设置来避免将压缩文件返回到无法进行解压缩的客户端。
`Path`	（继承自 `ConfigurationSection`。）一个键属性。
`SectionInformation`	（从 `ConfigurationSection` 继承。）
`SendCacheHeaders`	一个读/写 `boolean` 值。如果在 `CacheControlHeader` 和 `ExpiresHeader` 属性中配置的标头随着压缩响应一起发送，则为 `true`；否则为 `false`。默认为 `false`。
`StaticCompressionDisableCpuUsage`	一个读/写 `uint32` 值，指定将禁用静态压缩的 CPU 使用率百分比。默认值为 100。该值必须介于 0 和 100 之间。每 30 秒计算一次 CPU 使用率平均值。注意：此属性充当关闭静态压缩的 CPU 上限。当 CPU 使用率低于 `StaticCompressionEnableCpuUsage` 属性中指定的值时，将重新启用静态压缩。
`StaticCompressionEnableCpuUsage`	一个读/写 `uint32` 值，指定将启用静态压缩的 CPU 使用率百分比。默认值为 50。该值必须介于 0 和 100 之间。每 30 秒计算一次 CPU 使用率平均值。注意：此属性充当关闭静态压缩的 CPU 下限。当 CPU 使用率高于 `StaticCompressionDisableCpuUsage` 属性中指定的值时，将禁用静态压缩。
`StaticTypes`	StaticTypeSettings 值，包含 IIS 可以提供静态压缩的文件扩展名。

子类

此类不包含子类。

注解

默认情况下，静态压缩在 IIS 7 中处于打开状态。添加了 StaticCompressionEnableCpuUsage、StaticCompressionDisableCpuUsage、DynamicCompressionEnableCpuUsage 和 DynamicCompressionDisableCpuUsage 属性，以动态启用或禁用压缩，具体取决于 CPU 负载。

IIS 6.0 中的以下压缩属性不再存在于 IIS 7 中：

[HcCompressionBufferSize]()
HcCreateFlags
HcDoOnDemandCompression
HcFileExtensions
HcFilesDeletedPerDiskFree
HcIoBufferSize
HcMaxQueueLength
HcPriority
HcScriptFileExtensions

示例

以下示例显示 HttpCompressionSection 类中的非数组属性，并列出静态和动态压缩数组属性。

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject( _  
    "winmgmts:root\WebAdministration")  
  
' Get the HTTP compression section.  
Set oSection = oWebAdmin.Get( _  
    "HttpCompressionSection.Path=" & _  
    "'MACHINE/WEBROOT/APPHOST',Location=''")  
  
' Display the properties that are not collections.  
WScript.Echo "HttpCompressionSection properties"  
WScript.Echo "---------------------------------"  
WScript.Echo "Directory: " & oSection.Directory  
WScript.Echo "DoDiskSpaceLimiting: " & _  
    oSection.DoDiskSpaceLimiting  
WScript.Echo "DynamicCompressionDisableCpuUsage: " & _  
    oSection.DynamicCompressionDisableCpuUsage  
WScript.Echo "DynamicCompressionEnableCpuUsage: " & _  
    oSection.DynamicCompressionEnableCpuUsage  
WScript.Echo "ExpiresHeader: " & oSection.ExpiresHeader  
WScript.Echo "MaxDiskSpaceUsage: " & _  
    oSection.MaxDiskSpaceUsage  
WScript.Echo "MinFileSizeForComp: " & _  
    oSection.MinFileSizeForComp  
WScript.Echo "NoCompressionForProxies: " & _  
    oSection.NoCompressionForProxies  
WScript.Echo "NoCompressionForRange: " & _  
    oSection.NoCompressionForRange  
WScript.Echo "SendCacheHeaders: " & _  
    oSection.SendCacheHeaders  
WScript.Echo "StaticCompressionDisableCpuUsage: " & _  
    oSection.StaticCompressionDisableCpuUsage  
WScript.Echo "StaticCompressionEnableCpuUsage: " & _  
    oSection.StaticCompressionEnableCpuUsage  
WScript.Echo  
  
' Display the static compression types.  
WScript.Echo _  
    "HttpCompressionSection.StaticTypes.StaticTypes"  
WScript.Echo _  
    "----------------------------------------------"  
For Each oType In oSection.StaticTypes.StaticTypes  
    WScript.Echo "MimeType: " & oType.MimeType  
    WScript.Echo "Enabled: " & oType.Enabled  
    WScript.Echo  
Next  
WScript.Echo  
  
' Display the dynamic compression types.  
WScript.Echo _  
    "HttpCompressionSection.DynamicTypes.DynamicTypes"  
WScript.Echo _  
    "------------------------------------------------"  
For Each oType In oSection.DynamicTypes.DynamicTypes  
    WScript.Echo "MimeType: " & oType.MimeType  
    WScript.Echo "Enabled: " & oType.Enabled  
    WScript.Echo  
Next  
  
' Display the compression scheme elements.  
WScript.Echo "HttpCompressionSection.HttpCompression"  
WScript.Echo "-----------------------------------"  
For Each oScheme In oSection.HttpCompression  
    WScript.Echo "Name: " & oScheme.Name  
    WScript.Echo "Dll: " & oScheme.Dll  
    WScript.Echo "DoStaticCompression: " & _  
        oScheme.DoStaticCompression  
    WScript.Echo "StaticCompressionLevel: " & _  
        oScheme.StaticCompressionLevel  
    WScript.Echo "DoDynamicCompression: " & _  
        oScheme.DoDynamicCompression  
    WScript.Echo "DynamicCompressionLevel: " & _  
        oScheme.DynamicCompressionLevel  
    WScript.Echo  
Next

继承层次结构

ConfigurationSection

ConfigurationSectionWithCollection

HttpCompressionSection

要求

类型	描述
客户端	- IIS 7.0（在 Windows Vista 上） - IIS 7.5（在 Windows 7 上） - IIS 8.0（在 Windows 8 上） - IIS 10.0（在 Windows 10 上）
服务器	- IIS 7.0（在 Windows Server 2008 上） - IIS 7.5（在 Windows Server 2008 R2 上） - IIS 8.0（在 Windows Server 2012 上） - IIS 8.5（在 Windows Server 2012 R2 上） - IIS 10.0（在 Windows Server 2016 上）
产品	- IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0
MOF 文件	WebAdministration.mof

另请参阅

ConfigurationSectionWithCollection 类
 DynamicTypeSettings 类
 HttpCompressionMimeTypeElement 类
 HttpCompressionSchemeElement 类
 StaticTypeSettings 类

通过

HttpCompressionSection 类

语法

方法

属性

子类

注解

示例

继承层次结构

要求

另请参阅

反馈

其他资源