Contenu statique <staticContent>

Article
03/25/2024

Vue d’ensemble

L’élément <staticContent> configure plusieurs paramètres associés au traitement des demandes portant sur des fichiers statiques dans Internet Information Services (IIS) 7.

L’élément <staticContent> contient les trois attributs suivants qui spécifient si IIS 7 doit appliquer un pied de page de document aux fichiers statiques :

L’attribut enableDocFooter spécifie si les pieds de page de document sont activés.
L’attribut defaultDocFooter contient l’un des éléments suivants :
- Une chaîne de texte qu’IIS 7 utilisera pour le pied de page de document si l’attribut isDocFooterFileName est défini sur false
- Le chemin d’accès complet à un fichier contenant le texte qu’IIS 7 utilisera pour le pied de page de document si l’attribut isDocFooterFileName est défini sur true.
Comme indiqué ci-dessus, l’attribut isDocFooterFileName spécifie si l’attribut defaultDocFooter contient une chaîne de texte utilisée par IIS 7 pour le pied de page de document ou alors le chemin d’accès complet à un fichier contenant le texte utilisé par IIS 7 pour le pied de page de document.

Remarque

Par défaut, l’attribut isDocFooterFileName est défini sur false et est verrouillé globalement. Si vous voulez utiliser des fichiers pour les pieds de page de document, vous devez définir l’attribut isDocFooterFileName sur true au niveau global, ou déverrouiller l’attribut. Pour en savoir plus sur le verrouillage et le déverrouillage des attributs, consultez la procédure pas à pas Comment utiliser le verrouillage dans la configuration d’IIS 7.0.

Compatibilité

Version	Notes
IIS 10.0	L’élément `<staticContent>` n’a fait l’objet d’aucune modification dans IIS 10.0.
IIS 8.5	L’élément `<staticContent>` n’a fait l’objet d’aucune modification dans IIS 8.5.
IIS 8.0	L’élément `<staticContent>` n’a fait l’objet d’aucune modification dans IIS 8.0.
IIS 7.5	L’élément `<staticContent>` n’a fait l’objet d’aucune modification dans IIS 7.5.
IIS 7.0	L’élément `<staticContent>` a été introduit dans IIS 7.0.
IIS 6.0	L’élément `<staticContent>` remplace les propriétés de métabase IIS 6.0 suivantes : DefaultDocFooter EnableDocFooter

Programme d’installation

L’élément <staticContent> est inclus dans l’installation par défaut d’IIS 7.

Procédure

Il n’existe pas d’interface utilisateur permettant de configurer l’élément <staticContent> dans IIS 7. Pour obtenir des exemples sur la façon de configurer l’élément <staticContent> programmatiquement, consultez la section Exemples de code de ce document.

Configuration

Attributs

Attribut	Description
`defaultDocFooter`	Attribut de chaîne facultatif. Spécifie soit le texte du pied de page par défaut pour chaque page web d’un site, soit le chemin d’un fichier qui contient le texte du pied de page par défaut. La façon dont IIS 7 utilise cette propriété dépend de la valeur de l’attribut isDocFooterFileName. Remarque : le pied de page personnalisé est envoyé uniquement si l’attribut enableDocFooter a la valeur true.
`enableDocFooter`	Attribut booléen facultatif. Spécifie si le texte indiqué par l’attribut defaultDocFooter doit s’afficher sur chaque page statique d’un site web. La valeur par défaut est `false`.
`isDocFooterFileName`	Attribut booléen facultatif. Spécifie si la chaîne dans l’attribut defaultDocFooter indique le chemin d’un fichier qui contient le texte du pied de page par défaut pour chaque page statique sur un site web. La valeur par défaut est `false`.

Éléments enfants

Élément	Description
`clientCache`	Élément facultatif. Spécifie les paramètres de mise en cache du contenu statique qui est envoyé au client.
`mimeMap`	Élément facultatif. Spécifie une liste des extensions de nom de fichier pour les mappages MIME.

Exemple Configuration

L’exemple de configuration suivant active un pied de page de document pour le contenu statique et ajoute un avis de copyright simple comme texte de pied de page.

<configuration>
   <system.webServer>
      <staticContent enableDocFooter="true"
         defaultDocFooter="The information in this web site is copyrighted." />
   </system.webServer>
</configuration>

Exemple de code

Les exemples de code suivants activent un pied de page de document pour le contenu statique et ajoutent un avis de copyright simple comme texte de pied de page.

AppCmd.exe

appcmd.exe set config "Default Web Site" -section:system.webServer/staticContent /enableDocFooter:"True"

appcmd.exe set config "Default Web Site" -section:system.webServer/staticContent /defaultDocFooter:"The information in this web site is copyrighted."

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample
{
   private static void Main()
   {
      using (ServerManager serverManager = new ServerManager())
      {
         Configuration config = serverManager.GetWebConfiguration("Default Web Site");

         ConfigurationSection staticContentSection = config.GetSection("system.webServer/staticContent");
         staticContentSection["defaultDocFooter"] = @"The information in this web site is copyrighted.";
         staticContentSection["enableDocFooter"] = true;

         serverManager.CommitChanges();
      }
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample

   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetWebConfiguration("Default Web Site")

      Dim staticContentSection As ConfigurationSection = config.GetSection("system.webServer/staticContent")
      staticContentSection("defaultDocFooter") = "The information in this web site is copyrighted."
      staticContentSection("enableDocFooter") = True

      serverManager.CommitChanges()
   End Sub

End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST/Default Web Site";

var staticContentSection = adminManager.GetAdminSection("system.webServer/staticContent", "MACHINE/WEBROOT/APPHOST/Default Web Site");
staticContentSection.Properties.Item("defaultDocFooter").Value = "The information in this web site is copyrighted.";
staticContentSection.Properties.Item("enableDocFooter").Value = true;

adminManager.CommitChanges();

VBScript

Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST/Default Web Site"

Set staticContentSection = adminManager.GetAdminSection("system.webServer/staticContent", "MACHINE/WEBROOT/APPHOST/Default Web Site")
staticContentSection.Properties.Item("defaultDocFooter").Value = "The information in this web site is copyrighted."
staticContentSection.Properties.Item("enableDocFooter").Value = True

adminManager.CommitChanges()

Partager via