Procedimiento para agregar opciones de configuración personalizadas para extender una aplicación web

La carpeta \\Program Files\Common Files\Microsoft Shared\web server extensions\12\CONFIG contiene archivos .config y .xml que se usan de forma conjunta para crear el archivo Web.config para una aplicación web cuando se extiende con Windows SharePoint Services. Antes de copiar el archivo Web.config de la carpeta \CONFIG en la carpeta raíz de la aplicación web, Windows SharePoint Services busca en la carpeta \CONFIG todos los archivos .xml con un nombre con el formato webconfig.*.xml y combina su contenido con el archivo Web.config antes de escribir el archivo Web.config resultante en la ruta de acceso raíz de la aplicación web. Las acciones definidas en el archivo .xml se aplican a las opciones de configuración de la aplicación web. Una de las ventajas principales que conlleva usar un archivo .xml para complementar el archivo Web.config es que las personalizaciones no se pierden al actualizar Windows SharePoint Services y el archivo Web.config no se sobrescribe.

Ejemplo

Al guardar como webconfig.miNombre.xml en el directorio \CONFIG, en el siguiente ejemplo, se agrega un control seguro y se reemplaza el filtro en tiempo de ejecución para el archivo Web.config resultante que se crea al extender una aplicación 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>

En el ejemplo se agrega un elemento secundario SafeControl nuevo en la ruta de acceso configuration/SharePoint/SafeControls, se quita el elemento RuntimeFilter de la ruta de acceso configuration/SharePoint/RuntimeFilter y se agrega un elemento RuntimeFilter nuevo en la ruta de acceso configuration/SharePoint.

Para aplicar los cambios de forma retroactiva a los archivos Web.config del servidor, ejecute la operación desde la línea de comandos copyappbincontent Stsadm. Debe ejecutar la operación en cada servidor cliente web de la implementación.

Para obtener información general acerca de los archivos Web.config usados en una implementación de Windows SharePoint Services, consulte Trabajo con archivos Web.config

Advertencia

Los cambios realizados en Web.config se pueden sobrescribir al instalar actualizaciones o Service Packs para Windows SharePoint Services o al actualizar una instalación a la versión del producto siguiente.

Vea también

Otros recursos

Trabajo con archivos Web.config
Procedimiento para usar el modelo de objetos a fin de modificar Web.config