Класс HttpCompressionSection

Статья
07/10/2024

Настраивает сжатие HTTP.

Синтаксис

class HttpCompressionSection : ConfigurationSectionWithCollection

Методы

В следующей таблице перечислены методы, предоставляемые классом HttpCompressionSection .

Имя	Описание
Прибавить	(Наследуется от ConfigurationSectionWithCollection.)
Clear	(Является наследником `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 (WWW), прежде чем изменения свойства `CacheControlHeader` вступают в силу. Примечание. Заголовок `Cache-Control` отправляется с заголовком `HTTP Expires` , указанным в свойстве `ExpiresHeader` . Это сочетание заголовков гарантирует, что старые клиенты и прокси-серверы не пытаются кэшировать сжатые файлы.
`Directory`	Значение чтения и записи `string` , указывающее каталог, в котором сжатые версии статических файлов временно хранятся и кэшируются. Значением по умолчанию является "%SystemDrive%\inetpub\temp\IIS Временные сжатые файлы". IIS 7 создает вложенную папку в этой папке для каждого пула приложений и вложенную папку в каждой папке пула приложений для каждой схемы сжатия. Примечание. Путь к каталогу по умолчанию для временных сжатых файлов IIS в IIS 6.0 был %Windir%\\IIS Временные сжатые файлы, а была использована неструктурированная структура каталогов.
`DoDiskSpaceLimiting`	Значение чтения и записи `boolean` . `true` Значение , если ограничение существует для объема дискового пространства, которое может занять сжатые файлы в папке сжатых файлов; `false`в противном случае . Значение по умолчанию — `true`. Папка сжатых файлов указывается свойством `Directory` .
`DynamicCompressionDisableCpuUsage`	Значение чтения и записи `uint32` , указывающее процент использования ЦП, при котором будет отключено динамическое сжатие. Значение по умолчанию — 90. Значение должно быть от 0 до 100. Среднее использование ЦП вычисляется каждые 30 секунд. Примечание. Это свойство выступает в качестве верхнего предела ЦП, при котором отключается динамическое сжатие. Если загрузка ЦП снижается ниже значения, указанного в свойстве `DynamicCompressionEnableCpuUsage` , динамическое сжатие будет повторно использоваться.
`DynamicCompressionEnableCpuUsage`	Значение чтения и записи `uint32` , указывающее процент использования ЦП, ниже которого будет включена динамическая сжатие. Число по умолчанию — 50. Значение должно быть от 0 до 100. Среднее использование ЦП вычисляется каждые 30 секунд. Примечание. Это свойство выступает в качестве нижнего предела ЦП, ниже которого включена динамическая сжатие. При повышении использования ЦП выше значения, указанного в свойстве `DynamicCompressionDisableCpuUsage` , динамическое сжатие будет отключено.
`DynamicTypes`	Значение DynamicTypeSettings, содержащее расширения имен файлов, которые СЛУЖБЫ IIS могут обслуживать с динамическим сжатием.
`ExpiresHeader`	Значение чтения и записи `string` , указывающее содержимое заголовка `HTTP Expires` , отправленного с сжатыми файлами. Значением по умолчанию является "Wed, 01 январь 1997 г. 12:00:00 GMT". Чтобы включить этот параметр, необходимо задать `SendCacheHeaders` для `true`свойства значение . Необходимо также перезапустить службу WWW, прежде чем изменения свойства `ExpiresHeader` вступают в силу. Примечание. Заголовок `HTTP Expires` отправляется с заголовком `Cache-Control` , указанным в свойстве `CacheControlHeader` . Это сочетание заголовков гарантирует, что старые клиенты и прокси-серверы не пытаются кэшировать сжатые файлы.
`HttpCompression`	Массив значений HttpCompressionSchemeElement, указывающих схемы сжатия (Gzip или Deflate), которые IIS использует для сжатия клиентских запросов.
`Location`	(Наследуется от `ConfigurationSection`.) Свойство ключа.
`MaxDiskSpaceUsage`	Значение чтения и записи `uint32` , указывающее ограничение места на диске в мегабайтах, которое сжатые файлы могут занимать в каталоге сжатия. Значение по умолчанию равно 100. Если пространство, используемое сжатыми файлами, превышает 90 процентов значения, `MaxDiskSpaceUsage`iis удаляет наименее недавно использованные файлы до достижения уровня 90-процентного использования. Примечание. В IIS 6.0 это ограничение выражается в байтах; в IIS 7 оно выражается в мегабайтах. В IIS 7 ограничение применяется для каждого пула приложений.
`MinFileSizeForComp`	Значение чтения и записи `uint32` , указывающее минимальный размер файла в килобайтах для сжатия файла. Значение по умолчанию равно 256.
`NoCompressionForHttp10`	Значение чтения и записи `boolean` . `true` Значение , если сжатие отключено для запросов, содержащих номер версии HTTP 1.0; `false`в противном случае . Значение по умолчанию — `true`. Примечание. Некоторые клиенты HTTP 1.0 не обрабатывают кэширование сжатых объектов правильно. Этот параметр можно использовать, чтобы избежать возврата сжатого файла клиенту, который не может распаковать его.
`NoCompressionForProxies`	Значение чтения и записи `boolean` . `true` Значение , если сжатие отключено для запросов HTTP 1.1, поступающих через прокси-сервер; `false`в противном случае . Значение по умолчанию — `true.` Примечание. Некоторые прокси-серверы HTTP не обрабатывают кэширование сжатых объектов правильно. Этот параметр можно использовать, чтобы избежать возврата сжатого файла на прокси-сервер, который не может распаковывать его.
`NoCompressionForRange`	Значение чтения и записи `boolean` . `true` Значение Range />, если сжатие отключено для HTTP-запросов, включающих заголовок; в противном случае `false`. Значение по умолчанию — `true`. Примечание. Некоторые клиенты не могут правильно обрабатывать запросы диапазона. Этот параметр можно использовать, чтобы избежать возврата сжатого файла клиенту, который не может распаковать его.
`Path`	(Наследуется от `ConfigurationSection`.) Свойство ключа.
`SectionInformation`	(Является наследником `ConfigurationSection`)
`SendCacheHeaders`	Значение чтения и записи `boolean` . `true` Значение , если заголовки, настроенные в `CacheControlHeader` свойствах, `ExpiresHeader` отправляются с сжатыми ответами; в противном случае `false`. Значение по умолчанию — `false`.
`StaticCompressionDisableCpuUsage`	Значение чтения и записи `uint32` , указывающее процент использования ЦП, при котором отключается статическое сжатие. Значение по умолчанию равно 100. Значение должно быть от 0 до 100. Среднее использование ЦП вычисляется каждые 30 секунд. Примечание. Это свойство выступает в качестве верхнего предела ЦП, при котором статическое сжатие отключается. Если загрузка ЦП опускается ниже значения, указанного в свойстве `StaticCompressionEnableCpuUsage` , статическая сжатие будет повторно активирована.
`StaticCompressionEnableCpuUsage`	Значение чтения и записи `uint32` , указывающее процент использования ЦП, при котором включена статическое сжатие. Число по умолчанию — 50. Значение должно быть от 0 до 100. Среднее использование ЦП вычисляется каждые 30 секунд. Примечание. Это свойство выступает в качестве нижнего предела ЦП, ниже которого включена статическое сжатие. При повышении использования ЦП выше значения, указанного в свойстве `StaticCompressionDisableCpuUsage` , статическая сжатие будет отключена.
`StaticTypes`	Значение StaticTypeSettings, содержащее расширения имен файлов, которые СЛУЖБЫ IIS могут обслуживать со статическим сжатием.

Подклассы

Этот класс не содержит подклассов.

Замечания

Статическая сжатие включена по умолчанию в IIS 7. Свойства StaticCompressionEnableCpuUsageи DynamicCompressionDisableCpuUsage свойства DynamicCompressionEnableCpuUsageStaticCompressionDisableCpuUsageдобавлены для включения или отключения сжатия во время полета в зависимости от загрузки ЦП.

Следующие свойства сжатия из 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

Поделиться через