Compartir a través de

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

  • Artículo

Actualización: noviembre 2007

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.

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)

<connectionStrings > 
   <add />
   <clear />
   <remove />
</connectionStrings>

Atributos y elementos

En las siguientes secciones se describen atributos, elementos secundarios y elementos primarios de este elemento.

Atributos

Ninguno, excepto los 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

Elemento

Descripción

Add

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

Clear

Quita todas las referencias a cadenas de conexión heredadas y permite sólo las cadenas de conexión agregadas por el elemento add actual.

remove

Quita de la colección de cadenas de conexión una referencia a una cadena de conexión heredada.

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.

Comentarios

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.

En las versiones anteriores de ASP.NET, las cadenas de conexión se almacenaban en appSettings. En ASP.NET 2.0, características como Sesión, Suscripción, Personalización y Administrador de funciones se basan en las cadenas de conexión almacenadas en el elemento connectionStrings. También se puede utilizar el elemento connectionStrings con el fin de almacenar las cadenas de conexión de las aplicaciones propias del usuario.

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 connectionStrings predeterminado se configura en el archivo Machine.config.

Puede tener acceso al elemento connectionStrings mediante programación. Para obtener más información, vea el ejemplo de ConnectionStrings.

<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 dos cadenas de conexión. La primera la puede usar una aplicación ASP.NET y la segunda la utiliza el elemento sqlCacheDependency, que se configura posteriormente.

<configuration>
<!-- Other configuration settings -->

<connectionStrings>

  <add name="Sales" 
       providerName="System.Data.SqlClient"
       connectionString= "server=myserver;database=Products;uid=<user name>;pwd=<secure password>" />

  <add name="NorthWind" 
       providerName="System.Data.SqlClient" 
       connectionString="server=.;database=NorthWind;Integrated Security=SSPI" />

</connectionStrings>

<cache>
  <sqlCacheDependency enabled="true" pollTime="60000">
    <databases>
      <add name="Northwind" />
    </databases>
  </sqlCacheDependency>
</cache>

</configuration>

Información de elemento

Controlador de la sección de configuración

ConnectionStringsSection

Miembro de configuración

ConnectionStringSettingsCollection

ConnectionStrings

ConnectionStrings

ConnectionStrings

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

Microsoft Internet Information Services (IIS) 5.0, 5.1 ó 6.0

.NET Framework 2.0

Microsoft Visual Studio 2003 o Visual Studio 2005

Vea también

Tareas

Cómo: Bloquear los valores de configuración de ASP.NET

Conceptos

Información general sobre la configuración de ASP.NET

Proteger la configuración de ASP.NET

Información general sobre el acceso a datos en ASP.NET

Crear la base de datos de servicios de la aplicación para SQL Server

Proteger el acceso a datos

Referencia

Elemento configuration (Esquema de configuración general)

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

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

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

Otros recursos

Opciones de configuración de ASP.NET