Contenu statique <staticContent>
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.
Notes
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.
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 :
|
L’élément <staticContent>
est inclus dans l’installation par défaut d’IIS 7.
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.
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é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. |
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>
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 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."
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();
}
}
}
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
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();
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()