Utiliser des fichiers Web.config
Dernière modification : mercredi 28 juillet 2010
S’applique à : SharePoint Foundation 2010
Vous serez peut-être amené à modifier des fichiers web.config pour que votre solution fonctionne dans l'environnement Microsoft SharePoint Foundation. Par exemple, vous devrez peut-être ajouter une entrée SafeControl, inscrire un HttpModule ou personnaliser SessionState, mais un déploiement SharePoint Foundation comprend de nombreux fichiers web.config. Par exemple, il en existe un par application Web et une copie sur chaque serveur Web frontal.
Pour faciliter la personnalisation des fichiers web.config, SharePoint Foundation offre deux possibilités d’apporter des modifications. Tout d’abord, vous pouvez inscrire de façon déclarative des entrées web.config en créant un fichier XML qui contient un ensemble de modifications web.config. Pour ce faire, créez un fichier webconfig.XYZ.xml personnalisé déployé sur %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\CONFIG, où XYZ est un ID unique qui vous permet d’identifier votre solution. Pour un exemple de création d’un fichier web.config personnalisé en vue de modifier des paramètres, voir Comment : créer un fichier .config supplémentaire.
Outre créer un fichierwebconfig.XYZ.xml supplémentaire personnalisé, vous pouvez utiliser le modèle objet SharePoint Foundation pour modifier les paramètres web.config. Pour un exemple de modification des paramètres par programme, voir Comment : ajouter et supprimer par programme des paramètres Web.config.
Les modifications que vous définissez par le biais du modèle objet ou de code XML sont toujours appliquées lorsque vous créez une application Web.
Emplacement des fichiers Web.config
Les fichiers Web.config se trouvent dans les dossiers suivants du système de fichiers :
\\Inetpub\wwwroot\wss\VirtualDirectories\numéro_port : fichier web.config qui définit les paramètres de configuration d’une application de contenu Web SharePoint.
\\Inetpub\wwwroot\wss\VirtualDirectories\numéro_port_Administration_centrale : fichier web.config qui définit les paramètres de configuration de l’application Administration centrale SharePoint.
\\Inetpub\wwwroot\wss\VirtualDirectories\numéro_port\wpresources : fichier web.config utilisé dans les ressources de composants WebPart de l'application Web.
\\Program Files\Common Files\Microsoft Shared\Web Server Extensions\wpresources : fichier web.config utilisé dans les ressources de composants WebPart pour le Global Assembly Cache.
Important
Les fichiers web.config dans les dossiers \wpresources ne doivent pas être modifiés. Les paramètres de ces fichiers interdisent les pages ou les éléments pouvant être compilés. Si ces paramètres sont modifiés, l'état de sécurité du code compilé diffère considérablement de l'état de sécurité du code qui s'exécute à partir du répertoire lecteur_local:\Inetpub\wwwroot.
%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\CONFIG : fichier web.config et autres fichiers .config qui, ensemble, définissent les paramètres de configuration pour l’extension d’autres applications Web.
%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\ISAPI : fichier web.config qui définit les paramètres de configuration du répertoire virtuel /_vti_bin.
%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\LAYOUTS : fichier web.config qui définit les paramètres de configuration du répertoire virtuel /_layouts.
Lorsqu'une application Web SharePoint Foundation est créée, un fichier web.config de niveau supérieur est placé dans le dossier racine de contenu de l'application Web, qui définit les paramètres de configuration du serveur, tels que la gestion HTTP des composants WebPart. Un autre fichier web.config utilisé pour les ressources de composants WebPart est placé dans un dossier \wpresources à l'intérieur du même dossier racine.
.gif "Note Attention") Attention |
|---|
Les modifications que vous apportez à l'un des fichiers web.config intégrés à SharePoint Foundation ou créés lors de la création d'une application Web SharePoint Foundation risquent d'être écrasés lorsque vous installez des mises à jour ou des Service Packs pour SharePoint Foundation, ou lorsque vous mettez à niveau une installation vers la version suivante du produit. C'est pourquoi nous vous recommandons de ne pas modifier directement ces fichiers. Apportez des modifications aux paramètres web.config à l'aide de l'une des méthodes décrites dans la procédure Comment : créer un fichier .config supplémentaire ou de la méthode décrite dans la procédure Comment : ajouter et supprimer par programme des paramètres Web.config. Quelle que soit la méthode utilisée, il est possible de réappliquer vos paramètres personnalisés après la mise à niveau. |