Comment : créer un fichier .config supplémentaire

Dernière modification : jeudi 19 avril 2012

S’applique à : SharePoint Foundation 2010

Le dossier %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\CONFIG contient les fichiers .config et .xml qui, ensemble, permettent de créer le fichier web.config pour une application Web dans Microsoft SharePoint Foundation. Avant de copier le fichier web.config à partir du dossier \CONFIG dans le dossier racine de l’application Web, SharePoint Foundation vérifie si le dossier \CONFIG contient un fichier .xml portant un nom de la forme webconfig.*.xml et fusionne son contenu avec le fichier web.config. Les actions définies dans le fichier .xml sont appliquées aux paramètres de configuration de l’application Web. Un avantage majeur de l’utilisation d’un fichier .xml pour compléter le fichier web.config est que les personnalisations ne sont pas perdues lorsque SharePoint Foundation est mis à niveau et que le fichier web.config est remplacé.

Exemple

Une fois enregistré sous le nom de fichier webconfig.monNom.xml dans le répertoire \CONFIG, l’exemple suivant ajoute un contrôle sécurisé et remplace le filtre d’exécution du fichier web.config obtenu lors de l’extension d’une application Web.

<actions>
   <add path="configuration/SharePoint/SafeControls">
      <SafeControl
         Assembly="System.Web, Version=1.0.5000.0, Culture=neutral, 
            PublicKeyToken=b03f5f7f11d50a3a"
         Namespace="System.Web.UI.WebControls"
         TypeName="*"
         Safe="True"/>
   </add>
   <remove path="configuration/SharePoint/RuntimeFilter"/>
   <add path="configuration/SharePoint">
      <RuntimeFilter
         Assembly="Company.Product, Version=1.0.1000.0, 
            Culture=neutral, PublickKeyToken=1111111111"
         Class="MyRuntTimeFilter",
         BuilderUrl="MyBuilderUrl"/>
   </add>
</actions>

L’exemple ajoute un nouvel élément enfant SafeControl au Xpath configuration/SharePoint/SafeControls, supprime l’élément RuntimeFilter du Xpath configuration/SharePoint/RuntimeFilter et ajoute un nouvel élément RuntimeFilter au Xpath configuration/SharePoint.

Vous pouvez rétroactivement appliquer des modifications aux fichiers web.config du serveur en exécutant l’opération de ligne de commande Stsadm copyappbincontent. Vous devez exécuter l’opération sur chaque serveur Web frontal dans le déploiement.

Pour obtenir des informations générales sur les fichiers web.config utilisés dans un déploiement SharePoint Foundation, voir Utiliser des fichiers Web.config

Attention

Les modifications que vous apportez aux fichiers web.config générés dans SharePoint Foundation, ou créés en même temps qu’une application Web SharePoint Foundation, risquent d’être écrasés lorsque vous installez des mises à jour ou des Service Packs pour SharePoint Foundation, ou si vous mettez à niveau une installation vers une nouvelle version de produit. Pour cette raison, il est recommandé de ne pas modifier directement ces fichiers. Adaptez les paramètres de web.config en suivant la méthode décrite dans cette rubrique ou celle mentionnée dans Comment : ajouter et supprimer par programme des paramètres Web.config. Ces deux procédures vous permettent d’appliquer vos réglages personnalisés après la mise à niveau.

Voir aussi

Concepts

Utiliser des fichiers Web.config

Comment : ajouter et supprimer par programme des paramètres Web.config