Trabajo con archivos Web.config
Última modificación: miércoles, 28 de julio de 2010
Hace referencia a: SharePoint Foundation 2010
Es posible que deba modificar los archivos web.config para que la solución funcione en el entorno de Microsoft SharePoint Foundation. Por ejemplo, es posible que tenga que agregar una entrada SafeControl, registrar un HttpModule o personalizar SessionState, pero una implementación de SharePoint Foundation incluye numerosos archivos web.config. Por ejemplo, hay uno para cada aplicación web, así como una copia de cada uno de estos en cada servidor front-end web.
Para que sea más fácil personalizar los archivos web.config, SharePoint Foundation proporciona dos formas de realizar cambios. En primer lugar, se pueden registrar de forma declarativa entradas de web.config mediante la creación de un archivo XML que contenga un conjunto de modificaciones de web.config. Para ello, cree un archivo webconfig.XYZ.xml personalizado en %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\CONFIG, donde XYZ es un identificador único que se usa para identificar la solución. Para obtener un ejemplo que muestra cómo crear un archivo web.config personalizado para cambiar la configuración, vea Procedimiento para crear un archivo adicional .config.
Además de crear un archivo webconfig.XYZ.xml adicional, puede usar el modelo de objetos de SharePoint Foundation para modificar la configuración de web.config. Para obtener un ejemplo que muestra cómo modificar la configuración mediante programación, vea Procedimiento para agregar y quitar la configuración de Web.config mediante programación.
Los cambios que se definen mediante el modelo de objetos o con XML siempre se aplican cuando se crea una aplicación web.
Ubicaciones de los archivos Web.config
Los archivos Web.config se incluyen en las siguientes carpetas dentro del sistema de archivos:
\\Inetpub\wwwroot\wss\VirtualDirectories\númeroDePuerto: archivo web.config que define las opciones de configuración para una aplicación web de contenido de SharePoint.
\\Inetpub\wwwroot\wss\VirtualDirectories\númeroDePuertoDeAdministraciónCentral: archivo web.config que define las opciones de configuración para la aplicación Administración central de SharePoint.
\\Inetpub\wwwroot\wss\VirtualDirectories\númeroDePuerto\wpresources: archivo web.config usado en los recursos de elementos web de la aplicación web.
\\Program Files\Common Files\Microsoft Shared\Web Server Extensions\wpresources: archivo web.config que se usa en los recursos de elementos web para la memoria caché global de ensamblados.
.gif "Nota importante")
ImportanteLos archivos web.config de las carpetas \wpresources no deben modificarse. La configuración de estos archivos no permite usar páginas ni elementos que se puedan compilar. Si se modifica esta configuración, el estado de seguridad del código compilado diferirá en gran medida del estado de seguridad del código que se ejecuta desde el directorio unidadLocal:\Inetpub\wwwroot.
%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\CONFIG: archivo web.config y otros archivos .config que definen de forma conjunta las opciones de configuración para extender otras aplicaciones web.
%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\ISAPI: archivo web.config que define las opciones de configuración para el directorio virtual /_vti_bin.
%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\LAYOUTS: archivo web.config que define las opciones de configuración para el directorio virtual /_layouts.
Cuando se crea una aplicación web de SharePoint Foundation, se coloca un archivo web.config de nivel superior dentro de la carpeta raíz de contenido de la aplicación web; de este modo, se definen las opciones de configuración para el servidor, como el control de HTTP para elementos web. Otro archivo web.config usado para los recursos de elementos web se coloca en una carpeta \wpresources dentro de la misma carpeta raíz.
| Precaución |
|---|
Es posible que se sobrescriban los cambios que realice en cualquiera de los archivos web.config integrados en SharePoint Foundation o creados durante la creación de una aplicación web de SharePoint Foundation cuando instale actualizaciones o Service Pack para SharePoint Foundation, o cuando realice una actualización de una instalación a la siguiente versión de producto. Por este motivo, se recomienda que no edite directamente estos archivos. Realice cambios en la configuración de web.config mediante el método que se describe en Procedimiento para crear un archivo adicional .config o el método que se describe en Procedimiento para agregar y quitar la configuración de Web.config mediante programación. Después de la actualización, se podrá volver a aplicar la configuración personalizada mediante cualquiera de estos dos métodos. |