Classe HttpCompressionSection

Artigo
03/26/2024

Configura a compactação HTTP.

Sintaxe

class HttpCompressionSection : ConfigurationSectionWithCollection

Métodos

A tabela a seguir lista os métodos expostos pela classe HttpCompressionSection.

Nome	Descrição
Add	(Herdado de ConfigurationSectionWithCollection.)
Limpar	(Herdado de `ConfigurationSectionWithCollection`.)
Get	(Herdado de `ConfigurationSectionWithCollection`.)
GetAllowDefinition	(Herdado de ConfigurationSection.)
GetAllowLocation	(Herdado de `ConfigurationSection`.)
Remover	(Herdado de `ConfigurationSectionWithCollection`.)
RevertToParent	(Herdado de `ConfigurationSection`.)
SetAllowDefinition	(Herdado de `ConfigurationSection`.)
SetAllowLocation	(Herdado de `ConfigurationSection`.)

Propriedades

A tabela a seguir lista as propriedades expostas pela classe HttpCompressionSection.

Nome	Descrição
`CacheControlHeader`	Um valor de leitura/gravação `string` que especifica o cabeçalho `Cache-Control` que é enviado com arquivos compactados. O padrão é “max-age=86400”. Para habilitar essa configuração, você deve definir a propriedade `SendCacheHeaders` como `true`. Você também deve reiniciar o serviço WWW (World Wide Web Publishing Service) antes que as alterações na propriedade `CacheControlHeader` entrem em vigor. Observação: o cabeçalho `Cache-Control` é enviado com o cabeçalho `HTTP Expires` especificado na propriedade `ExpiresHeader`. Essa combinação de cabeçalhos garante que clientes mais antigos e servidores proxy não tentem armazenar arquivos compactados em cache.
`Directory`	O valor `string` de leitura/gravação especifica o diretório em que as versões compactadas dos arquivos estáticos são temporariamente armazenadas e armazenadas em cache. O padrão é “%SystemDrive%\inetpub\temp\IIS Temporary Compressed Files”. O IIS 7 cria uma subpasta nessa pasta para cada pool de aplicativos e uma subpasta em cada pasta do pool de aplicativos para cada esquema de compactação. Observação: o caminho de diretório padrão para arquivos compactados temporários do IIS no IIS 6.0 era %Windir%\\IIS Arquivos Compactados Temporários e uma estrutura de diretório simples foi usada.
`DoDiskSpaceLimiting`	Um valor `boolean` de leitura/gravação. `true` se existir um limite para a quantidade de espaço em disco que os arquivos compactados na pasta Arquivos Compactados podem ocupar; caso contrário, `false`. O padrão é `true`. A pasta arquivos compactados é especificada pela propriedade `Directory`.
`DynamicCompressionDisableCpuUsage`	Um valor `uint32` de leitura/gravação que especifica o percentual de utilização da CPU na qual a compactação dinâmica será desabilitada. O padrão é 90. O valor precisa estar entre 0 e 100. A utilização média da CPU é calculada a cada 30 segundos. Observação: essa propriedade atua como um limite superior da CPU no qual a compactação dinâmica é desativada. Quando a utilização da CPU ficar abaixo do valor especificado na propriedade `DynamicCompressionEnableCpuUsage`, a compactação dinâmica será reativada.
`DynamicCompressionEnableCpuUsage`	Um valor `uint32` de leitura/gravação que especifica o percentual de utilização da CPU abaixo, na qual a compactação dinâmica será habilitada. O padrão é 50. O valor precisa estar entre 0 e 100. A utilização média da CPU é calculada a cada 30 segundos. Observação: essa propriedade atua como um limite de CPU inferior abaixo do qual a compactação dinâmica é ativada. Quando a utilização da CPU for superior ao valor especificado na propriedade, a compactação dinâmica `DynamicCompressionDisableCpuUsage` será desabilitada.
`DynamicTypes`	Um valor DynamicTypeSettings que contém extensões de nome de arquivo que o IIS pode servir com compactação dinâmica.
`ExpiresHeader`	Um valor `string` de leitura/gravação que especifica o conteúdo do cabeçalho `HTTP Expires` que é enviado com arquivos compactados. O padrão é “Wed, 01 Jan 1997 12:00:00 GMT”. Para habilitar essa configuração, você deve definir a propriedade `SendCacheHeaders` como `true`. Você também deve reiniciar o serviço WWW antes que as alterações na propriedade `ExpiresHeader` entrem em vigor. Observação: o cabeçalho `HTTP Expires` é enviado com o cabeçalho `Cache-Control` especificado na propriedade `CacheControlHeader`. Essa combinação de cabeçalhos garante que clientes mais antigos e servidores proxy não tentem armazenar arquivos compactados em cache.
`HttpCompression`	Uma matriz de valores HttpCompressionSchemeElement que especificam os esquemas de compactação (Gzip ou Deflate) que o IIS usa para compactar solicitações de cliente.
`Location`	(Herdado de `ConfigurationSection`.) Uma propriedade chave.
`MaxDiskSpaceUsage`	Um valor `uint32` de leitura/gravação que especifica um limite de espaço em disco, em megabytes, que os arquivos compactados podem ocupar no diretório de compactação. O padrão é 100. Quando o espaço usado por arquivos compactados excede 90% do valor no `MaxDiskSpaceUsage`, os IIS excluem os arquivos menos usados recentemente até que um nível de uso de 90% seja atingido. Observação: nos IIS 6.0, esse limite é expresso em bytes; nos IIS 7, ele é expresso em megabytes. Nos IIS 7, o limite é aplicado por pool de aplicativos.
`MinFileSizeForComp`	Um valor `uint32` de leitura/gravação que especifica o tamanho mínimo do arquivo, em quilobytes, para um arquivo a ser compactado. O padrão é 256.
`NoCompressionForHttp10`	Um valor `boolean` de leitura/gravação. `true` se a compactação estiver desabilitada para solicitações que contenham um número de versão HTTP 1.0; caso contrário, `false`. O padrão é `true`. Observação: alguns clientes HTTP 1.0 não manipulam o cache de objetos compactados corretamente. Você pode usar essa configuração para evitar o retorno de um arquivo compactado para um cliente que não pode descompactá-lo.
`NoCompressionForProxies`	Um valor `boolean` de leitura/gravação. `true` se a compactação estiver desabilitada para solicitações HTTP 1.1 que vêm por meio de um servidor proxy; caso contrário, `false`. O padrão é `true.` Observação: alguns servidores proxy HTTP não lidam com o cache de objetos compactados corretamente. Você pode usar essa configuração para evitar o retorno de um arquivo compactado para um servidor proxy que não pode descompactá-lo.
`NoCompressionForRange`	Um valor `boolean` de leitura/gravação. `true` se a compactação estiver desabilitada para solicitações HTTP que incluem o `Range` cabeçalho; caso contrário, `false`. O padrão é `true`. Observação: alguns clientes não podem lidar com solicitações de intervalo corretamente. Você pode usar essa configuração para evitar o retorno de um arquivo compactado para um cliente que não pode descompactá-lo.
`Path`	(Herdado de `ConfigurationSection`.) Uma propriedade chave.
`SectionInformation`	(Herdado de `ConfigurationSection`.)
`SendCacheHeaders`	Um valor `boolean` de leitura/gravação. `true` se os cabeçalhos configurados `CacheControlHeader` nas propriedades e `ExpiresHeader` forem enviados com respostas compactadas; caso contrário, `false`. O padrão é `false`.
`StaticCompressionDisableCpuUsage`	Um valor `uint32` de leitura/gravação que especifica o percentual de utilização da CPU na qual a compactação estática é desabilitada. O padrão é 100. O valor precisa estar entre 0 e 100. A utilização média da CPU é calculada a cada 30 segundos. Observação: essa propriedade atua como um limite superior da CPU no qual a compactação estática é desativada. Quando a utilização da CPU ficar abaixo do valor especificado na propriedade `StaticCompressionEnableCpuUsage`, a compactação estática será reativada.
`StaticCompressionEnableCpuUsage`	Um valor `uint32` de leitura/gravação que especifica o percentual de utilização da CPU na qual a compactação estática é habilitada. O padrão é 50. O valor precisa estar entre 0 e 100. A utilização média da CPU é calculada a cada 30 segundos. Observação: essa propriedade atua como um limite de CPU inferior abaixo do qual a compactação estática é ativada. Quando a utilização da CPU for superior ao valor especificado na propriedade `StaticCompressionDisableCpuUsage`, a compactação estática será desabilitada.
`StaticTypes`	Um valor StaticTypeSettings que contém extensões de nome de arquivo que o IIS pode servir com compactação estática.

Subclasses

Essa classe não contém subclasses.

Comentários

A compactação estática está ativada por padrão no IIS 7. As propriedades StaticCompressionEnableCpuUsage, StaticCompressionDisableCpuUsage, DynamicCompressionEnableCpuUsage e DynamicCompressionDisableCpuUsage foram adicionadas para habilitar ou desabilitar a compactação em tempo real, dependendo da carga da CPU.

As seguintes propriedades de compactação do IIS 6.0 não estão mais presentes no IIS 7:

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

Exemplo

O exemplo a seguir exibe as propriedades não matriz na classe HttpCompressionSection e lista as propriedades de matriz de compactação estática e dinâmica.

' 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

Hierarquia de herança

ConfigurationSection

ConfigurationSectionWithCollection

HttpCompressionSection

Requisitos

Tipo	Descrição
Cliente	– IIS 7.0 no Windows Vista – IIS 7.5 no Windows 7 – IIS 8.0 no Windows 8 – IIS 10.0 no Windows 10
Servidor	– IIS 7.0 no Windows Server 2008 – IIS 7.5 no Windows Server 2008 R2 – IIS 8.0 no Windows Server 2012 – IIS 8.5 no Windows Server 2012 R2 – IIS 10.0 no Windows Server 2016
Product	– IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
Arquivo MOF	WebAdministration.mof

Confira também

Classe ConfigurationSectionWithCollection
DynamicTypeSettings Class
HttpCompressionMimeTypeElement Class
HttpCompressionSchemeElement Class
StaticTypeSettings Class

Compartilhar via

Classe HttpCompressionSection

Sintaxe

Métodos

Propriedades

Subclasses

Comentários

Exemplo

Hierarquia de herança

Requisitos

Confira também

Comentários

Recursos adicionais