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

Artículo
10/07/2008

Actualización: noviembre 2007

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.

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

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

Atributos y elementos

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

Atributos

Atributo	Descripción
connectionString	Atributo String requerido. 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 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 requerido de cada archivo de configuración utilizado por Common Language Runtime y las aplicaciones de .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 directorios virtuales o físicos
Requisitos	Servicios de Microsoft Internet Information Server (IIS) 5.0, 5.1 ó 6.0 .NET Framework 2.0 Microsoft Visual Studio 2003 o Visual Studio 2005

Vea también

Compartir a través de