Classe UrlCompressionSection

Article
03/25/2024

Active ou désactive la compression dynamique ou statique.

Syntaxe

class UrlCompressionSection : ConfigurationSection

Méthodes

Le tableau suivant répertorie les méthodes exposées par la classe UrlCompressionSection.

Nom	Description
GetAllowDefinition	(Hérité de ConfigurationSection.)
GetAllowLocation	(Hérité de `ConfigurationSection`.)
RevertToParent	(Hérité de `ConfigurationSection`.)
SetAllowDefinition	(Hérité de `ConfigurationSection`.)
SetAllowLocation	(Hérité de `ConfigurationSection`.)

Propriétés

Le tableau suivant répertorie les propriétés exposées par la classe UrlCompressionSection.

Nom	Description
`DoDynamicCompression`	Valeur `boolean` en lecture/écriture. `true` si la compression dynamique est activée pour les URL ; sinon, `false`. Par défaut, il s’agit de `false`. Remarque : l’utilisation de la compression dynamique peut augmenter l’utilisation du processeur et réduire les performances globales du serveur Web.
`DoStaticCompression`	Valeur `boolean` en lecture/écriture. `true` si la compression statique est activée pour les URL ; sinon, `false`. Par défaut, il s’agit de `true`.
`DynamicCompressionBeforeCache`	Valeur `boolean` en lecture/écriture. `true` si la réponse actuellement disponible est compressée dynamiquement avant d’être placée dans le cache de sortie ; sinon, `false`. Par défaut, il s’agit de `false`. Pour plus d'informations, consultez la section Notes.
`Location`	(Hérité de `ConfigurationSection`.) Propriété clé.
`Path`	(Hérité de `ConfigurationSection`.) Propriété clé.
`SectionInformation`	(Hérité de `ConfigurationSection`.)

Sous-classes

Cette classe ne contient aucune sous-classe.

Notes

Lorsque la propriété DynamicCompressionBeforeCache est true, IIS compresse dynamiquement la réponse la première fois qu’une requête est formulée. La réponse compressée est placée dans le cache de sortie et la réponse mise en cache est envoyée au client. Les requêtes suivantes sont traitées à partir de la réponse compressée dans le cache de sortie.

Quand DynamicCompressionBeforeCache est false, IIS place la réponse non compressée dans le cache de sortie. Ensuite, chaque fois que la réponse est demandée, IIS compresse dynamiquement la réponse mise en cache à mesure qu’elle est envoyée au client.

Si vous définissez la propriété DynamicCompressionBeforeCache sur true, le processeur compresse dynamiquement la réponse une seule fois, et non chaque fois que la page est demandée. Étant donné que la compression dynamique est très consommatrice de processeur, un paramètre de true peut réduire la charge du serveur et améliorer le débit du site.

Remarque

Si la propriété DynamicCompressionBeforeCacheest true lorsque la réponse du cache de sortie a été vidée, la compression dynamique n’est pas effectuée avant que la réponse ne soit placée dans le cache de sortie. Toutefois, si la propriété DoDynamicCompression est true , la compression dynamique se produit malgré tout une fois que la réponse a été placée dans le cache de sortie.

Exemple

L’exemple suivant répertorie les paramètres de compression dynamique et statique pour tous les chemins d’accès et tous les emplacements sur un serveur Web. Une propriété Location vide dans la sortie indique que le paramètre est global.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Get the URL compression section.  
Set oUrlCompressionSection = oWebAdmin.ExecQuery( _  
    "SELECT * FROM UrlCompressionSection")  
  
' List the dynamic and static compression settings for each location.  
For Each vUrlCompressionProperty In oUrlCompressionSection  
    WScript.Echo "Location: " & vUrlCompressionProperty.Location  
    WScript.Echo "DoDynamicCompression: " & _  
        vUrlCompressionProperty.DoDynamicCompression  
    WScript.Echo "DoStaticCompression: " & _  
        vUrlCompressionProperty.DoStaticCompression  
    WScript.Echo  
Next

Hiérarchie d'héritage

ConfigurationSection

UrlCompressionSection

Spécifications

Type	Description
Client	- IIS 7.0 sur Windows Vista - IIS 7.5 sous Windows 7 - IIS 8.0 sous Windows 8 - IIS 10.0 sous Windows 10
Serveur	- IIS 7.0 sur Windows Server 2008 - IIS 7.5 sur Windows Server 2008 R2 - IIS 8.0 sur Windows Server 2012 - IIS 8.5 sur Windows Server 2012 R2 - IIS 10.0 sous Windows Server 2016
Produit	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
Fichier MOF	WebAdministration.mof

Voir aussi

Classe ConfigurationSection
Classe HttpCompressionSection

Partager via