Classe HttpCompressionSection
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 manipulam 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]()
HcCreateFlagsHcDoOnDemandCompressionHcFileExtensionsHcFilesDeletedPerDiskFreeHcIoBufferSizeHcMaxQueueLengthHcPriorityHcScriptFileExtensions
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
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
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de