Compartir a través de


<appSettings> elemento para <configuration>

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>

Syntax

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

Atributo

Atributo Description
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 especifican en los <add>elementos , <remove>y y <clear> 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. En el caso de las aplicaciones de Web Forms, la ruta de acceso es relativa a la raíz de la aplicación, donde se encuentra el archivo web.config .

El tiempo de ejecución omite el atributo si no se encuentra el archivo especificado.

Elemento primario

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

Elementos secundarios

Elemento secundario Description
<agregar> Agrega una configuración de aplicación personalizada.
<claro> Borra toda la configuración de la aplicación definida anteriormente.
<eliminar> Quita una configuración de aplicación definida anteriormente.

Observaciones

El <appSettings> elemento almacena información de configuración de aplicaciones personalizadas, 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 obtiene acceso a los pares clave-valor especificados en el <appSettings> elemento en el código mediante la ConfigurationSettings clase .

Puede usar el file atributo en el <appSettings> elemento de los archivos de configuración deWeb.config y aplicación. Este atributo especifica un archivo de configuración que proporciona valores adicionales o invalida la configuración especificada en el <appSettings> elemento . El file atributo 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 la aplicación.

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

Example

En el ejemplo siguiente se muestra un archivo de configuración de aplicación externa (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 aplicación que consume la configuración en el archivo de configuración externo y establece una configuración de aplicación propia:

<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 máquina (Machine.config) y Web.config archivos que no están en el nivel de directorio de la aplicación.

Consulte también