Archivos de configuración

Los archivos de configuración son archivos XML que se pueden cambiar según sea necesario. Los programadores pueden usar archivos de configuración para cambiar valores sin volver a compilar las aplicaciones. Los administradores pueden usar los archivos de configuración para establecer directivas que afectan al modo en que se ejecutan las aplicaciones en sus equipos.

Nota
El código administrado puede utilizar las clases del espacio de nombres System.Configuration para leer los valores desde los archivos de configuración, pero no para escribir valores de configuración en dichos archivos.

En este tema se describe la sintaxis de los archivos de configuración y se proporciona información sobre los tres tipos de archivos de configuración: de equipo, de aplicación y de seguridad.

Formato de archivos de configuración

Los archivos de configuración contienen elementos, que son estructuras de datos lógicas que establecen la información de configuración. En un archivo de configuración se usan etiquetas para marcar el comienzo y el final de un elemento. Por ejemplo, el elemento <runtime> consta de <runtime>elementos secundarios</runtime>. Un elemento vacío tiene una etiqueta inicial, pero no etiqueta final.

Los valores de configuración se especifican mediante atributos predefinidos, que son los pares de nombre y valor dentro de la etiqueta inicial de un elemento. En el ejemplo siguiente se especifican dos atributos (version y href) para el elemento <codeBase>, que especifica dónde puede ubicar el tiempo de ejecución un ensamblado (para obtener más información, vea Especificar la ubicación de un ensamblado).

<codeBase version="2.0.0.0"
          href="http://www.litwareinc.com/myAssembly.dll"/>

Importante
Como ocurre con todos los archivos XML, la sintaxis de los archivos de configuración distingue mayúsculas de minúsculas.

Archivos de configuración del equipo

El archivo de configuración del equipo, Machine.config, contiene valores que afectan a todo un equipo. Este archivo se encuentra en el directorio %ruta de instalación del tiempo de ejecución%\Config. Machine.config contiene valores de configuración para el enlace de ensamblados en todo el equipo, canales de comunicación remota integrados y ASP.NET.

El sistema de configuración busca elemento appSettings primero en el archivo de configuración del equipo y en otras secciones de configuración que pueda definir un desarrollador. Después, busca en el archivo de configuración de la aplicación. Para que el archivo de configuración del equipo sea siempre manejable, es mejor ubicar estos valores en el archivo de configuración de la aplicación. Sin embargo, si se ubican los valores en el archivo de configuración del equipo, el sistema puede ser más fácil de mantener. Por ejemplo, si se tiene un componente de terceros que utilizan las aplicaciones de cliente y servidor, es más fácil poner los valores de ese componente en un lugar. En este caso, el archivo de configuración del equipo es el lugar adecuado para los valores, para no tener los mismos valores en dos archivos.

Nota
Si se implementa una aplicación mediante XCOPY, no se copiarán los valores en el archivo de configuración del equipo.

Para obtener más información sobre cómo usa Common Language Runtime el archivo de configuración del equipo para el enlace de ensamblados, vea Cómo ubica ensamblados el motor en tiempo de ejecución.

Archivos de configuración de la aplicación

Los archivos de configuración de la aplicación contienen valores específicos de una aplicación. Este archivo contiene valores de configuración que lee Common Language Runtime (como la directiva de enlace de ensamblados, objetos de comunicación remota, etc.) y valores que puede leer la aplicación.

El nombre y la ubicación del archivo de configuración de la aplicación dependen del host de la aplicación, que puede ser:

• Aplicación hospedada en un ejecutable.

  El archivo de configuración de una aplicación hospedada por el host ejecutable está en el mismo directorio que la aplicación. El nombre del archivo de configuración es el nombre de la aplicación, con la extensión .config. Por ejemplo, una aplicación denominada myApp.exe se puede asociar a un archivo de configuración denominado myApp.exe.config.

  Nota
  En proyectos Visual Studio, coloque el archivo .config en el directorio de proyecto y establezca su propiedad Copy To Output Directory en Copiar siempre o Copiar si es posterior.Visual Studio copia automáticamente el archivo en el directorio donde compila el ensamblado.

• Aplicación hospedada en ASP.NET.

  Para obtener más información sobre los archivos de configuración de ASP.NET, vea Opciones de configuración de ASP.NET.

• Aplicación hospedada en Internet Explorer.

  Si una aplicación hospedada en Internet Explorer tiene un archivo de configuración, la ubicación de este archivo se especifica en una etiqueta <link> con la sintaxis siguiente:

  <link rel="nombreArchivoConfiguración" href="ubicación">

  En esta etiqueta, location es una dirección URL para el archivo de configuración. Esto establece la base de la aplicación. El archivo de configuración debe estar ubicado en el mismo sitio Web que la aplicación.

Archivos de configuración de seguridad

Los archivos de configuración de seguridad contienen información sobre la jerarquía de grupos de código y conjuntos de permisos asociados a un nivel de directiva. Se recomienda encarecidamente usar la herramienta Configuración de .NET Framework (Mscorcfg.msc) o la herramienta de la directiva de seguridad de acceso del código (Caspol.exe) para modificar la directiva de seguridad y garantizar que los cambios de directiva no dañen los archivos de configuración de seguridad.

Nota
A partir de .NET Framework 4, los archivos de configuración de seguridad solo están presentes si se ha modificado la directiva de seguridad.

Los archivos de configuración de seguridad están en las ubicaciones siguientes:

• Archivo de configuración de directiva de empresa: %ruta de instalación del tiempo de ejecución%\Config\Enterprisesec.config

• Archivo de configuración de directiva de equipo: %ruta de instalación del tiempo de ejecución%\Config\Security.config

• Archivo de configuración de directiva de usuario: %USERPROFILE%\Application data\Microsoft\CLR security config\vxx.xx\Security.config

Vea también

Referencia

Mscorcfg.msc (Herramienta de configuración de .NET Framework)

Caspol.exe (Herramienta de la directiva de seguridad de acceso del código)

Conceptos

Especificar la ubicación de un ensamblado

Redirigir versiones de ensamblado

Ensamblados en Common Language Runtime

Otros recursos

Esquema de los archivos de configuración de .NET Framework

Opciones de configuración de ASP.NET

Administración de directivas de seguridad

Remote Objects

Historial de cambios