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

2008-10-07

Actualización: noviembre 2007

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

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

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

Atributos y elementos

Las siguientes secciones describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo	Descripción
key	Atributo String requerido. 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

Atributo String requerido.

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 en cada archivo de configuración usado por Common Language Runtime y las aplicaciones .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.

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.

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	Servicios de Microsoft Internet Information Server (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

Compartir a través de