Elemento add para appSettings (Esquema de configuración general)

Artículo
08/10/2011

Agrega una configuración de aplicación personalizada como par de nombre y valor a la colección de configuraciones de aplicación.

<add
   key="String name"
   value="String value"
/>

Atributos y elementos

En las secciones siguientes se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo	Descripción
key	El atributo String es obligatorio. Especifica el nombre de la opción de configuración de la aplicación. Este atributo es la clave de la colección.
value	Atributo String requerido. Especifica el valor de la opción de configuración de la aplicación.
Atributos heredados	Atributos opcionales Atributos que todos los elementos de sección heredan. Para obtener más información, vea Atributos generales heredados por elementos de una sección.

key

El atributo String es obligatorio.

Especifica el nombre de la opción de configuración de la aplicación. Este atributo es la clave de la colección.

value

Atributo String requerido.

Especifica el valor de la opción de configuración de la aplicación.

Atributos heredados

Atributos opcionales

Atributos que todos los elementos de sección heredan. Para obtener más información, vea Atributos generales heredados por elementos de una sección.

Elementos secundarios

Ninguno.

Elementos primarios

Elemento	Descripción
configuration	Especifica el elemento raíz necesario de cada archivo de configuración que utilizan las aplicaciones basadas en Common Language Runtime y .NET Framework.
system.web	Especifica el elemento raíz de los valores de configuración de ASP.NET en un archivo de configuración y contiene elementos de configuración que configuran aplicaciones Web ASP.NET y controlan el comportamiento de las aplicaciones.
appSettings	Contiene la configuración de aplicación personalizada, como rutas de acceso de archivos, direcciones URL de servicios Web XML o cualquier información que se almacena en el archivo .ini de una aplicación.

Comentarios

El elemento add agrega una configuración de aplicación personalizada como par de nombre y valor a la colección de configuraciones de aplicación heredadas en el elemento appSettings.

Importante
Las claves deben ser únicas.Si agrega varias entradas con la misma clave, solo se conserva la última entrada.

El elemento appSettings contiene la configuración de aplicación personalizada, como rutas de acceso de archivos, direcciones URL de servicios Web XML o cualquier información que se almacena en el archivo .ini de una aplicación. Se puede tener acceso a los pares de clave y valor especificados en el elemento appSettings en el código utilizando la clase ConfigurationSettings. En el ejemplo de la clase se muestra cómo obtener acceso a appSettings mediante programación.

Configuración predeterminada

En las versiones 1.0 y 1.1 de .NET Framework, el siguiente elemento appSettings predeterminado se configura en el archivo Machine.config.

<appSettings>
        <add key="XML File Name" value="myXmlFileName.xml" /> 
    </appSettings>

Ejemplo

Los archivos de configuración que se especifican en un atributo file deben tener appSettings en lugar de configuration como nodo raíz. El código siguiente es correcto para un archivo de configuración especificado en el atributo file.

<?xml version="1.0" encoding="utf-8" ?>
<appSettings>
<add key="Application1" value="MyApplication1" />
<add key="Setting1" value="MySetting" />
</appSettings>

En el siguiente ejemplo de código se muestra cómo definir una configuración de aplicación personalizada en un archivo de configuración.

<configuration>
    <appSettings>
        <add key="Application Name" value="MyApplication" />
    </appSettings>
</configuration>

Información de elemento

Controlador de la sección de configuración	AppSettingsSection
Miembro de configuración	Add
Ubicaciones configurables	Machine.config Web.config del nivel raíz Web.config del nivel de aplicaciones Web.config del nivel de directorio virtual o físico
Requisitos	Microsoft Internet Information Services (IIS) versión 5.0, 5.1 ó 6.0 .NET Framework versión 1.0, 1.1 ó 2.0 Microsoft Visual Studio 2003 o Visual Studio 2005

Vea también