Procedimiento para crear un archivo adicional .config

Última modificación: jueves, 19 de abril de 2012

Hace referencia a: SharePoint Foundation 2010

La carpeta %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\CONFIG contiene archivos .config y .xml que se usan de forma conjunta para crear el archivo web.config para una aplicación web en Microsoft SharePoint Foundation. Antes de copiar el archivo web.config de la carpeta \CONFIG a la carpeta raíz de la aplicación web, SharePoint Foundation busca en la carpeta \CONFIG todos los archivos .xml que tengan un nombre con el formato webconfig.*.xml y combina su contenido con el archivo web.config. 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 SharePoint Foundation y al sobrescribir el archivo web.config.

Ejemplo

Cuando se guarda como webconfig.miNombre.xml en el directorio \CONFIG, en el siguiente ejemplo se agrega un control seguro y se reemplaza el filtro de 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 nuevo elemento secundario SafeControl en la expresión Xpath configuration/SharePoint/SafeControls, se quita el elemento RuntimeFilter de la expresión Xpath configuration/SharePoint/RuntimeFilter y se agrega un nuevo elemento RuntimeFilter a la expresión Xpath 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 Stsadm de copyappbincontent. Debe ejecutar la operación en cada servidor front-end web de la implementación.

Para obtener información general acerca de los archivos web.config usados en una implementación de SharePoint Foundation, vea Trabajo con archivos Web.config.

Precaución

Es posible que los cambios realizados en cualquiera de los archivos web.config que están integrados en SharePoint Foundation, o que se crean al crear una aplicación web de SharePoint Foundation, se sobrescriban al instalar actualizaciones o Service Pack de SharePoint Foundation, o bien al actualizar una instalación a la próxima versión del producto. Por este motivo, se recomienda no editar estos archivos directamente. Para realizar cambios en la configuración de web.config, use el método descrito en este tema o el método descrito en Procedimiento para agregar y quitar la configuración de Web.config mediante programación. Con cualquiera de ellos podrá volver a aplicar la configuración personalizada después de la actualización.

Vea también

Conceptos

Trabajo con archivos Web.config

Procedimiento para agregar y quitar la configuración de Web.config mediante programación