Classe HttpCompressionSection

Articolo
11/25/2024

Configura la compressione HTTP.

Sintassi

class HttpCompressionSection : ConfigurationSectionWithCollection

Metodi

Nella tabella seguente sono elencati i metodi esposti dalla HttpCompressionSection classe .

Nome	Descrizione
Aggiunta	Ereditato da ConfigurationSectionWithCollection.
Cancella	Ereditato da `ConfigurationSectionWithCollection`.
GET	Ereditato da `ConfigurationSectionWithCollection`.
GetAllowDefinition	Ereditato da ConfigurationSection.
GetAllowLocation	Ereditato da `ConfigurationSection`.
Rimuovi	Ereditato da `ConfigurationSectionWithCollection`.
RevertToParent	Ereditato da `ConfigurationSection`.
SetAllowDefinition	Ereditato da `ConfigurationSection`.
SetAllowLocation	Ereditato da `ConfigurationSection`.

Proprietà

Nella tabella seguente sono elencate le proprietà esposte dalla HttpCompressionSection classe .

Nome	Descrizione
`CacheControlHeader`	Valore di lettura/scrittura `string` che specifica l'intestazione `Cache-Control` inviata con file compressi. Il valore predefinito è "max-age=86400". Per abilitare questa impostazione, è necessario impostare la `SendCacheHeaders` proprietà su `true`. È inoltre necessario riavviare il servizio Www (World Wide Web Publishing Service) prima che le modifiche apportate alla `CacheControlHeader` proprietà vengano applicate. Nota: l'intestazione `Cache-Control` viene inviata con l'intestazione `HTTP Expires` specificata nella `ExpiresHeader` proprietà . Questa combinazione di intestazioni garantisce che i client e i server proxy meno recenti non tentino di memorizzare nella cache i file compressi.
`Directory`	Valore di lettura/scrittura `string` che specifica la directory in cui le versioni compresse dei file statici vengono archiviate temporaneamente e memorizzate nella cache. Il valore predefinito è "%SystemDrive%\inetpub\temp\IIS Temporary Compressed Files". IIS 7 crea una sottocartella in questa cartella per ogni pool di applicazioni e una sottocartella in ogni cartella del pool di applicazioni per ogni schema di compressione. Nota: il percorso di directory predefinito per i file compressi temporanei IIS in IIS 6.0 è %Windir%\\IIS Temporary Compressed Files e è stata usata una struttura di directory flat.
`DoDiskSpaceLimiting`	Valore di lettura/scrittura `boolean` . `true` se esiste un limite per la quantità di spazio su disco che i file compressi nella cartella dei file compressi possono occupare; in caso contrario, `false`. Il valore predefinito è `true`. La cartella dei file compressi viene specificata dalla `Directory` proprietà .
`DynamicCompressionDisableCpuUsage`	Valore di lettura/scrittura `uint32` che specifica la percentuale di utilizzo della CPU in corrispondenza della quale verrà disabilitata la compressione dinamica. Il valore predefinito è 90. Il valore deve essere compreso tra 0 e 100. L'utilizzo medio della CPU viene calcolato ogni 30 secondi. Nota: questa proprietà funge da limite di CPU superiore a cui è disattivata la compressione dinamica. Quando l'utilizzo della CPU scende al di sotto del valore specificato nella `DynamicCompressionEnableCpuUsage` proprietà, verrà riattivata la compressione dinamica.
`DynamicCompressionEnableCpuUsage`	Valore di lettura/scrittura `uint32` che specifica la percentuale di utilizzo della CPU al di sotto della quale verrà abilitata la compressione dinamica. Il valore predefinito è 50. Il valore deve essere compreso tra 0 e 100. L'utilizzo medio della CPU viene calcolato ogni 30 secondi. Nota: questa proprietà funge da limite di CPU inferiore al di sotto del quale è attivata la compressione dinamica. Quando l'utilizzo della CPU aumenta al di sopra del valore specificato nella `DynamicCompressionDisableCpuUsage` proprietà , la compressione dinamica verrà disabilitata.
`DynamicTypes`	Valore DynamicTypeSettings che contiene le estensioni di file che IIS può gestire con la compressione dinamica.
`ExpiresHeader`	Valore di lettura/scrittura `string` che specifica il contenuto dell'intestazione `HTTP Expires` inviata con file compressi. Il valore predefinito è "Wed, 01 Jan 1997 12:00:00 GMT". Per abilitare questa impostazione, è necessario impostare la `SendCacheHeaders` proprietà su `true`. È inoltre necessario riavviare il servizio WWW prima che le modifiche apportate alla `ExpiresHeader` proprietà vengano applicate. Nota: l'intestazione `HTTP Expires` viene inviata con l'intestazione `Cache-Control` specificata nella `CacheControlHeader` proprietà . Questa combinazione di intestazioni garantisce che i client e i server proxy meno recenti non tentino di memorizzare nella cache i file compressi.
`HttpCompression`	Matrice di valori HttpCompressionSchemeElement che specificano gli schemi di compressione (Gzip o Deflate) usati da IIS per comprimere le richieste client.
`Location`	Ereditato da `ConfigurationSection`. Proprietà chiave.
`MaxDiskSpaceUsage`	Valore di lettura/scrittura `uint32` che specifica un limite di spazio su disco, in megabyte, che i file compressi possono occupare nella directory di compressione. L'impostazione predefinita è 100. Quando lo spazio usato dai file compressi supera il 90% del valore in `MaxDiskSpaceUsage`, IIS elimina i file usati meno di recente finché non viene raggiunto un livello di utilizzo del 90%. Nota: in IIS 6.0 questo limite è espresso in byte; in IIS 7, viene espresso in megabyte. In IIS 7 il limite viene applicato per ogni pool di applicazioni.
`MinFileSizeForComp`	Valore di lettura/scrittura `uint32` che specifica la dimensione minima del file, espressa in kilobyte, per comprimere un file. L'impostazione predefinita è 256.
`NoCompressionForHttp10`	Valore di lettura/scrittura `boolean` . `true` se la compressione è disabilitata per le richieste che contengono un numero di versione HTTP 1.0; in caso contrario, `false`. Il valore predefinito è `true`. Nota: alcuni client HTTP 1.0 non gestiscono correttamente la memorizzazione nella cache di oggetti compressi. È possibile usare questa impostazione per evitare di restituire un file compresso a un client che non può decomprimerlo.
`NoCompressionForProxies`	Valore di lettura/scrittura `boolean` . `true` se la compressione è disabilitata per le richieste HTTP 1.1 che provengono da un server proxy; in caso contrario, `false`. Il valore predefinito è `true.` Nota: alcuni server proxy HTTP non gestiscono correttamente la memorizzazione nella cache di oggetti compressi. È possibile usare questa impostazione per evitare di restituire un file compresso a un server proxy che non può decomprimerlo.
`NoCompressionForRange`	Valore di lettura/scrittura `boolean` . `true` se la compressione è disabilitata per le richieste HTTP che includono l'intestazione `Range` ; in caso contrario, `false`. Il valore predefinito è `true`. Nota: alcuni client non possono gestire correttamente le richieste di intervallo. È possibile usare questa impostazione per evitare di restituire un file compresso a un client che non può decomprimerlo.
`Path`	Ereditato da `ConfigurationSection`. Proprietà chiave.
`SectionInformation`	Ereditato da `ConfigurationSection`.
`SendCacheHeaders`	Valore di lettura/scrittura `boolean` . `true` se le intestazioni configurate nelle `CacheControlHeader` proprietà e `ExpiresHeader` vengono inviate con risposte compresse; in caso contrario, `false`. Il valore predefinito è `false`.
`StaticCompressionDisableCpuUsage`	Valore di lettura/scrittura `uint32` che specifica la percentuale di utilizzo della CPU in corrispondenza della quale la compressione statica è disabilitata. L'impostazione predefinita è 100. Il valore deve essere compreso tra 0 e 100. L'utilizzo medio della CPU viene calcolato ogni 30 secondi. Nota: questa proprietà funge da limite di CPU superiore a cui la compressione statica è disattivata. Quando l'utilizzo della CPU scende al di sotto del valore specificato nella `StaticCompressionEnableCpuUsage` proprietà, la compressione statica verrà riabilitabile.
`StaticCompressionEnableCpuUsage`	Valore di lettura/scrittura `uint32` che specifica la percentuale di utilizzo della CPU in corrispondenza della quale è abilitata la compressione statica. Il valore predefinito è 50. Il valore deve essere compreso tra 0 e 100. L'utilizzo medio della CPU viene calcolato ogni 30 secondi. Nota: questa proprietà funge da limite di CPU inferiore al di sotto del quale è attivata la compressione statica. Quando l'utilizzo della CPU aumenta al di sopra del valore specificato nella proprietà, la `StaticCompressionDisableCpuUsage` compressione statica verrà disabilitata.
`StaticTypes`	Valore StaticTypeSettings che contiene estensioni di file che IIS può servire con la compressione statica.

Sottoclassi

Questa classe non contiene sottoclassi.

Osservazioni:

La compressione statica è attivata per impostazione predefinita in IIS 7. Le StaticCompressionEnableCpuUsageproprietà , StaticCompressionDisableCpuUsage, DynamicCompressionEnableCpuUsagee DynamicCompressionDisableCpuUsage sono state aggiunte per abilitare o disabilitare la compressione in tempo reale a seconda del carico della CPU.

Le proprietà di compressione seguenti di IIS 6.0 non sono più presenti in IIS 7:

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

Esempio

Nell'esempio seguente vengono visualizzate le proprietà non di matrice nella HttpCompressionSection classe e vengono elencate le proprietà della matrice di compressione statica e dinamica.

' 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

Gerarchia di ereditarietà

ConfigurationSection

ConfigurationSectionWithCollection

HttpCompressionSection

Requisiti

Tipo	Descrizione
Client	- IIS 7.0 in Windows Vista - IIS 7.5 in Windows 7 - IIS 8.0 in Windows 8 - IIS 10.0 in Windows 10
Server	- IIS 7.0 in Windows Server 2008 - IIS 7.5 in Windows Server 2008 R2 - IIS 8.0 in Windows Server 2012 - IIS 8.5 in Windows Server 2012 R2 - IIS 10.0 in Windows Server 2016
Prodotto	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
File MOF	WebAdministration.mof

Vedi anche

Classe ConfigurationSectionWithCollection
Classe DynamicTypeSettings
Classe HttpCompressionMimeTypeElement
Classe HttpCompressionSchemeElement
Classe StaticTypeSettings

Condividi tramite