Elemento connectionStrings (Esquema de configuración de ASP.NET)
Especifica una colección de cadenas de conexión de bases de datos, como pares nombre/valor, para características y aplicaciones ASP.NET.
Se trata de un elemento nuevo en .NET Framework, versión 2.0.
<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. En las aplicaciones ASP.NET, en tiempo de ejecución, puede asignar al atributo ConfigSource un nombre de un archivo de configuración alternativo. En este caso, la información de la cadena de conexión predeterminada incluida en el archivo Web.config sobrescribe el contenido del archivo. Esto también se produce cuando no existe el archivo alternativo y se crea en tiempo de ejecución. Si Web.config no contiene ninguna información de la cadena de conexión, una sección connectionStrings vacía se agrega al archivo alternativo.
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 conexiones una referencia a una cadena de conexión heredada. |
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. |
Comentarios
El elemento connectionStrings especifica una colección de cadenas de conexión de bases de datos, como pares nombre/valor, para características y aplicaciones 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, Pertenencia, 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 |
|
Miembro de configuración |
|
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
Tareas
Cómo: Bloquear los valores de configuración de ASP.NET
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)
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