Editar los archivos de configuración de ASP.NET
Actualización: noviembre 2007
Los datos de configuración de ASP.NET se almacenan en archivos de texto XML cuya denominación es Web.config. Los archivos Web.config pueden aparecer en varios directorios de las aplicaciones ASP.NET. Cada archivo Web.config aplica los valores de configuración a su propio directorio y a todos los directorios secundarios. Los valores de configuración de los directorios secundarios se pueden reemplazar opcionalmente, o se pueden modificar los valores de configuración especificados en los directorios primarios. La raíz de la jerarquía de configuración de ASP.NET es el archivo raízDelSistema\Microsoft.NET\Framework\versión\CONFIG\Web.config, que incluye los valores de configuración aplicables a todas las aplicaciones ASP.NET que ejecuten una versión concreta de Microsoft .NET Framework. Puesto que todas las aplicaciones ASP.NET heredan los valores de configuración predeterminados del archivo Web.config raíz, sólo es necesario crear archivos Web.config para los valores que deben reemplazar a los predeterminados.
Estructura de los archivos de configuración
Cada archivo de configuración contiene etiquetas y subetiquetas XML anidadas con atributos que especifican los valores de configuración. Toda la información de configuración reside entre las etiquetas XML raíz <configuration> y </configuration>. La información de configuración comprendida entre estas etiquetas se agrupa en dos áreas principales: el área de declaración del controlador de sección de configuración y el área de valores de la sección de configuración. Para obtener más información, vea Estructura de archivos de configuración de ASP.NET (secciones y controladores de sección).
Editar los valores de configuración
Dado que se trata de archivos XML de texto sin formato, los valores de configuración se pueden crear o editar de las maneras siguientes:
Mediante la API de configuración de ASP.NET. Para obtener más información, vea API de configuración de ASP.NET.
Mediante el complemento MMC de ASP.NET.
Mediante la herramienta Administración de sitios Web para sitios Web y aplicaciones ASP.NET. Para obtener más información, vea Herramienta Administración de sitios Web en ASP.NET.
Mediante un editor de texto o un editor XML para editar directamente los archivos de configuración. Para conocer la sintaxis correcta, vea los temas de referencia relacionados con la configuración en Opciones de configuración de ASP.NET y Opciones de configuración generales (ASP.NET).
Distinguir mayúsculas de minúsculas
Debido a su formato XML, en las etiquetas, las subetiquetas y los atributos se distingue entre mayúsculas y minúsculas. En los nombres de etiquetas y atributos, se utiliza la siguiente combinación de mayúsculas y minúsculas: la primera letra de la etiqueta es minúscula y la primera letra de cada palabra concatenada subsiguiente es mayúscula. En la mayoría de los casos, en los valores de los atributos de cadena se aplica el uso de mayúsculas y minúsculas de Pascal; es decir, el primer carácter es una mayúscula y la primera letra de cada palabra concatenada subsiguiente también es una mayúscula. Las excepciones son true y false, que siempre se escriben en minúscula.
Secciones personalizadas
En la infraestructura de configuración de ASP.NET no se atribuye ningún tipo de datos a las opciones de configuración. Las clases del controlador de sección de configuración procesan todos los datos de Web.config. Puede utilizar los controladores de sección de configuración predefinidos que se suministran con .NET Framework o crear sus propios controladores para procesar los datos de configuración personalizados.
Para obtener más información sobre cómo crear tipos de configuraciones personalizadas, vea Cómo: Crear secciones de configuración personalizadas mediante ConfigurationSection.
Editar archivos de configuración remotos
La API de configuración de ASP.NET permite a la aplicación modificar los archivos de configuración en un equipo remoto. En particular, se puede modificar en un equipo remoto el archivo Machine.config o Web.config en cualquier aplicación de Microsoft Internet Information Services (IIS) o sus directorios secundarios. Si no existe el archivo Web.config, los datos de configuración devueltos se compondrán en su totalidad de valores de configuración heredados que se apliquen a la ruta de acceso especificada. Si la aplicación solicita una actualización de estos datos de configuración devueltos, se creará un nuevo archivo. Para obtener más información, vea Editar los archivos de configuración remotos de ASP.NET y Cómo: Obtener acceso y modificar de manera remota los archivos de configuración de ASP.NET.
Los cambios de configuración provocan un reinicio del dominio de aplicación
Los cambios en los valores de configuración de los archivos Web.config causan indirectamente el reinicio del dominio de aplicación. Este comportamiento se debe al diseño. Puede utilizar opcionalmente el atributo configSource para hacer referencia a los archivos de configuración externos que no generan un reinicio cuando se realiza un cambio. Para obtener más información, vea configSource en Atributos generales heredados por elementos de una sección.
Los intentos de cambiar un archivo de configuración por parte de alguien que no tiene permisos para editar el archivo no provocan el reinicio del dominio de aplicación.
Para obtener más información, vea Administrar los cambios en los valores de configuración.
Vea también
Tareas
Cómo: Obtener acceso y modificar de manera remota los archivos de configuración de ASP.NET
Cómo: Crear secciones de configuración personalizadas mediante ConfigurationSection
Conceptos
Proteger la configuración de ASP.NET
Editar los archivos de configuración remotos de ASP.NET
Administrar los cambios en los valores de configuración
Referencia
Herramientas de .NET Framework