Compartir a través de


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

[Esta documentación se proporciona solo para fines preliminares y está sujeta a cambios en versiones posteriores. Se incluye temas en blanco como marcadores].

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 próximas secciones 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

El atributo String es obligatorio.

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 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.

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

Tareas

How to: Lock ASP.NET Configuration Settings

Referencia

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

Elemento configuration (Esquema de configuración general)

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

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

Conceptos

ASP.NET Configuration Overview

Securing Configuration

ASP.NET Data Access Overview

Securing Data Access

Configuration Inheritance