Compartir a través de

Cambio de configuración del archivo web.config

  • Artículo

El archivo web.config controla la mayor parte de la configuración para el entorno ASP.NET en la que se basan los Productos y Tecnologías de SharePoint actuales.

Ejemplo real

Un desarrollador debe registrar un elemento web globalmente como un control a prueba de errores y, opcionalmente, puede agregar opciones de configuración de la aplicación en el archivo web.config para que funcione correctamente. El desarrollador crea un archivo de modificación web.config nuevo que contiene la configuración apropiada, que posteriormente se instala en el servidor.

Detalles técnicos

Los archivos web.config son archivos XML almacenados en los directorios que se exponen mediante los Productos y Tecnologías de SharePoint y ASP.NET. Cada archivo web.config se compone de varios grupos de opciones de configuración, que controlan el funcionamiento de ASP.NET.

Pueden utilizarse archivos web.config de adición para aplicar los cambios de web.config globalmente en cada una de las aplicaciones web de un servidor. Se combinan entre sí para crear el archivo web.config para cada aplicación web de contenido. A continuación se muestra un ejemplo de un archivo web.config de adición, denominado webconfig.pwa.xml, incluido con Microsoft Office Project Server 2007.

<actions>
   <add path="configuration/SharePoint/SafeControls" id="{376C9977-14E1-4107-B599-2B091D22D477}">
      <SafeControl Assembly="Microsoft.Office.Project.Server.PWA, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" Namespace="Microsoft.Office.Project.PWA.WebParts" TypeName="*" Safe="True"/>
   </add>
   <add path="configuration/system.web/siteMap/providers" id="{2A7351DE-86A5-4a42-8D0C-86D352B52E8E}">
      <add name="PWASiteMapProvider" description="Project Web Access provider for global navigation" type="Microsoft.Office.Project.PWA.PWASiteMapProvider, Microsoft.Office.Project.Server.PWA, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" mode="Quick Launch" securityTrimmingEnabled="true" initializeMetadata="true"/>
      </add>
   <add path="configuration/system.web/httpModules" id="{B3156549-9487-45f9-BC83-C584C07A3527}">
   <add name="PwaAuthentication" type="Microsoft.Office.Project.PWA.PwaAuthenticationModule, Microsoft.Office.Project.Server.PWA, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" />
   </add>
</actions>

Los archivos webconfig de adición se almacenan en la ruta de acceso siguiente:

%COMMONPROGRAMFILES%\Microsoft Shared\Web server extensions\12\CONFIG

Puede utilizar soluciones para realizar adiciones de entradas de control a prueba de errores en los archivos web.config en cualquier aplicación web dondequiera que se implemente la aplicación. Éste es el método preferido para registrar entradas de control a prueba de errores de elementos web con la mínima intervención del equipo de soporte.

Detalles de soporte

Siempre que se modifica el archivo web.config, éste puede desencadenar una recarga del dominio de aplicación, lo que puede afectar a los usuarios finales a causa de la eliminación de la caché, la pérdida del estado de sesión, errores de procesamiento, interrupciones de cargas y descargas, o retrasos de carga de las páginas.