Elemento add para connectionStrings (Esquema de configuración de ASP.NET)

Artículo
08/10/2011

Agrega una cadena de conexión como un par de nombre y valor a la colección de cadenas de conexión.

Se trata de un elemento nuevo en .NET Framework versión 2.0.

<add 
   name="connection string name"
   connectionString="connection string"
   providerName="ADO.NET data provider" 
/>

Atributos y elementos

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

Atributos

Atributo	Descripción
connectionString	El atributo String es obligatorio. Define el valor de la cadena de conexión. El valor puede ser una cadena vacía (""). No se realiza ninguna comprobación para comprobar su validez. El valor predeterminado es una cadena vacía ("").
name	Atributo String requerido. Define la clave que se va a utilizar para obtener acceso al valor de la cadena de conexión. Este atributo reemplaza cualquier clave heredada con el mismo nombre. El valor predeterminado es una cadena vacía ("").
providerName	Atributo String opcional. Nombre del proveedor de ADO.NET que se va a utilizar para obtener acceso al almacén de datos subyacente. El valor predeterminado es "System.Data.SqlClient".
Atributos heredados	Atributos opcionales. Atributos heredados por todos los elementos de una sección. 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 ASP.NET en un archivo de configuración y contiene elementos de configuración que configuran las aplicaciones Web ASP.NET y controlan el comportamiento de las aplicaciones.
connectionStrings	Especifica una colección de cadenas de conexión a bases de datos (en forma de pares de nombre y valor) para las aplicaciones y características de ASP.NET.

Comentarios

El elemento add agrega una cadena de conexión como un par de nombre y valor a la colección de cadenas de conexión en el elemento connectionStrings.

El elemento connectionStrings especifica una colección de cadenas de conexión a bases de datos (en forma de pares de nombre y valor) para las aplicaciones y características de ASP.NET.

Configuración predeterminada

Las cadenas de conexión incluidas en un archivo de configuración principal se heredan, a menos que se utilice el elemento clear en el archivo de configuración secundario. El siguiente elemento element predeterminado se configura en el archivo Machine.config.

<connectionStrings>
   <add 
      name="LocalSqlServer" 
      connectionString="data source=.\SQLEXPRESS;Integrated Security=SSPI;AttachDBFilename=|DataDirectory|aspnetdb.mdf;User Instance=true" 
      providerName="System.Data.SqlClient"
   />
</connectionStrings>

Ejemplo

En el siguiente ejemplo de código se muestra cómo configurar una cadena de conexión para una aplicación que utiliza la base de datos Northwind.

<configuration>
  <connectionStrings>
    <add name="Northwind"
         connectionString="Data Source=localhost;Integrated Security=SSPI;Initial Catalog=Northwind;" 
         providerName="System.Data.SqlClient" />
  </connectionStrings>
</configuration>

Información de elemento

Controlador de la sección de configuración	ConnectionStringsSection
Miembro de configuración	Add(ConnectionStringSettings)
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 2.0 Microsoft Visual Studio 2003 o Visual Studio 2005

Vea también