Cette documentation est archivée et n’est pas conservée.

Procédure : utiliser le modèle objet pour modifier Web.config

Windows SharePoint Services 3

Dans Windows SharePoint Services 3.0, vous pouvez modifier les paramètres Web.config en créant un fichier XML qui décrit les modifications, ou vous pouvez effectuer la même tâche par programme à l'aide de la classe SPWebConfigModification de l'espace de noms Microsoft.SharePoint.Administration, ce qui vous permet d'enregistrer les entités dynamiquement.

Exemple

L'exemple suivant montre comment utiliser la classe SPWebConfigModification pour inscrire un assembly personnalisé. Pour plus d'informations sur la création d'une application qui implémente l'exemple, voir Mise en route de la personnalisation par programme d'un site Web SharePoint dans Visual Studio.

SPWebService service = SPWebService.ContentService;

SPWebConfigModification myModification = new SPWebConfigModification();
myModification.Path = "configuration/SharePoint/SafeControls";
myModification.Name = "SafeControl[@Assembly='MyCustomAssembly'][@Namespace='MyCustomNamespace'][@TypeName='*'][@Safe='True']";
myModification.Sequence = 0;
myModification.Owner = "User Name";
myModification.Type = SPWebConfigModification.SPWebConfigModificationType.EnsureChildNode;
myModification.Value = "<SafeControl Assembly='MyCustomAssembly' Namespace='MyCustomNamespace' TypeName='*' Safe='True' />";
service.WebConfigModifications.Add(myModification);
 
/*Call Update and ApplyWebConfigModifications to save changes*/ 
service.Update();
service.ApplyWebConfigModifications();

Dans l'exemple, la propriété Name contient une instruction XPath qui identifie le nœud de manière unique, ce qui évite l'ajout de doublons du nœud au fichier.

L'appel de la méthode ApplyWebConfigModifications permet de planifier un travail du minuteur pour déployer les modifications dans la batterie de serveurs. Pour appliquer une modification de web.config à une application Web spécifique, ajoutez la modification à la collection des modifications de web.config pour l'application Web ( WebConfigModifications). Par exemple, vous pouvez utiliser oWebSite.Site.WebApplication.WebConfigModifications.Add(MyModification) pour ajouter une modification de web.config à l'application Web parente d'un site Web spécifique.

Remarque Remarque :

Vous devez être administrateur sur le serveur Web frontal pour que votre code fonctionne.

Afficher: