Elemento <appSettings>
Contiene los valores personalizados de la aplicación. Ésta es una sección de configuración predefinida que proporciona .NET Framework.
<configuration>
** <appSettings>**
<appSettings file="relative file name">
</appSettings>
Atributo opcional
| Atributo | Descripción |
|---|---|
| file | Especifica una ruta de acceso relativa a un archivo externo que contiene valores de configuración personalizados de la aplicación. El archivo especificado contiene el mismo tipo de configuración que se especifican en los elementos <add>, <remove> y <clear>, y utiliza el mismo formato de pares clave/valor que dichos elementos.
La ruta de acceso especificada se refiere al archivo de configuración principal. Para una aplicación de formularios de Windows Forms, ésta sería la carpeta binaria (como /bin/debug), no la ubicación del archivo de configuración de la aplicación. Para las aplicaciones de formularios Web Forms, la ruta se refiere al directorio raíz de la aplicación, en el que está ubicado el archivo web.config. Tenga en cuenta que el motor de tiempo de ejecución ignorará el atributo si no se encuentra el archivo especificado. |
Elementos secundarios
| Elemento | Descripción |
|---|---|
| <add> | Agrega los valores personalizados de la aplicación. |
| <remove> | Quita un valor definido anteriormente en la aplicación. |
| <clear> | Borra todos los valores definidos anteriormente en la aplicación. |
Comentarios
El elemento <appSettings> almacena información de configuración personalizada de la aplicación, como cadenas de conexión de base de datos, rutas de acceso a archivos, direcciones URL de servicios Web XML o cualquier otra información registrada en el archivo .ini de una aplicación. Es posible obtener acceso en código a los pares clave/valor especificados en el elemento <appSettings> mediante la clase System.Configuration.ConfigurationSettings.
En el elemento <appSettings> del archivo Web.config y de los archivos de configuración de la aplicación, se puede usar el atributo file. Este atributo determina un archivo de configuración que proporciona valores adicionales o reemplaza los valores especificados en el elemento <appSettings>. El atributo file se puede utilizar en escenarios de desarrollo en equipo de controles de código fuente, como cuando un usuario desea reemplazar los valores del proyecto especificados en el archivo de configuración de una aplicación.
Los archivos de configuración especificados por el atributo file deben tener como nodo raíz <appSettings> en lugar de <configuration>. El código siguiente es correcto para un archivo de configuración especificado mediante el atributo file:
<?xml version="1.0" encoding="utf-8" ?>
<appSettings>
<add key="Application1" value="MyApplication1" />
<add key="Setting1" value="MySetting" />
</appSettings>
Ejemplo
En el siguiente ejemplo se muestra cómo definir un valor personalizado para una aplicación en un archivo de configuración.
<configuration>
<appSettings>
<add key="Application Name" value="MyApplication" />
</appSettings>
</configuration>
Archivo de configuración
Este elemento se puede utilizar en el archivo de configuración de la aplicación, en el archivo de configuración del equipo (Machine.config) y en los archivos Web.config que no se encuentran en el directorio de la aplicación.
Vea también
Esquema de secciones de configuración | Valores de la sección de configuración