<Elemento appSettings> para la <configuración>

Contiene la configuración de la aplicación personalizada. Se trata de una sección de configuración predefinida proporcionada por .NET Framework.

<configuration>
  <appSettings>

Sintaxis

<appSettings>
  <!-- Elements to add, clear, or remove configuration settings -->
</appSettings>

Atributo

Descripción

file

Atributo opcional. Especifica una ruta de acceso relativa a un archivo externo que contiene opciones de configuración de aplicaciones personalizadas. El archivo especificado contiene el mismo tipo de configuración que se especifica en los <elementos add>, <remove> y clear< y> usa el mismo formato de par clave-valor que esos elementos. La ruta de acceso especificada es relativa al archivo de configuración principal. Para una aplicación de Windows Forms, se trata de la carpeta binaria (como /bin/debug), no la ubicación del archivo de configuración de la aplicación. Para Web Forms aplicaciones, la ruta de acceso es relativa a la raíz de la aplicación, donde se encuentra el archivo web.config. El entorno de ejecución omite el atributo si no se encuentra el archivo especificado.

Elemento primario

	Descripción
Elemento <configuration>	Elemento raíz de cada archivo de configuración usado por las aplicaciones de Common Language Runtime y .NET Framework.

Elementos secundarios

	Descripción
<add>	Agrega una configuración de aplicación personalizada.
<clear>	Borra todas las configuraciones de aplicación definidas anteriormente.
<remove>	Quita una configuración de aplicación definida previamente.

Comentarios

El <elemento appSettings> almacena información de configuración de la aplicación personalizada, como cadenas de conexión de base de datos, rutas de acceso de archivo, direcciones URL del servicio web XML o cualquier otra información de configuración personalizada para una aplicación. Se tiene acceso a los pares clave-valor especificados en el <elemento appSettings> en el código mediante la clase ConfigurationSettings.

Puede usar el atributo file en el elemento <appSettings> de los archivos de configuración de la aplicación Web.config. Este atributo especifica un archivo de configuración que proporciona una configuración adicional o reemplaza la configuración especificada en el elemento <appSettings>. El atributo file se puede usar en escenarios de desarrollo del equipo de control de código fuente, como cuando un usuario quiere invalidar la configuración del proyecto especificada en un archivo de configuración de aplicación.

Los archivos de configuración especificados por el atributo de archivo deben tener un nodo raíz de <appSettings> en lugar de una <configuración>.

Ejemplo

En el ejemplo siguiente se muestra un archivo de configuración de la aplicación externo (custom.config) que define una configuración de aplicación personalizada:

<?xml version="1.0" encoding="utf-8" ?>
<appSettings>
  <add key="MyCustomSetting" value="MyCustomSettingValue" />
</appSettings>

En el ejemplo siguiente se muestra un archivo de configuración de la aplicación que usa la configuración del archivo de configuración externo y establece su propia configuración de la aplicación:

<configuration>
  <appSettings file="custom.config">
    <add key="ApplicationName" value="MyApplication" />
  </appSettings>
</configuration>

Archivo de configuración

Este elemento se puede usar en el archivo de configuración de la aplicación, el archivo de configuración de la máquina (Machine.config) y los archivos Web.config que no están en el nivel de directorio de la aplicación.

Consulte también

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