Condividi tramite


Elemento add per connectionStrings (schema delle impostazioni ASP.NET)

Aggiornamento: novembre 2007

Aggiunge una stringa di connessione come coppia di nome e valore all'insieme di stringhe di connessione.

Questo elemento è nuovo in .NET Framework versione 2.0.

Elemento configuration (schema delle impostazioni generali)
  Elemento connectionStrings (schema delle impostazioni ASP.NET)
    Elemento add per connectionStrings (schema delle impostazioni ASP.NET)

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

Attributi ed elementi

Nelle sezioni riportate di seguito vengono illustrati attributi, elementi figlio ed elementi padre.

Attributi

Attributo

Descrizione

connectionString

Attributo String obbligatorio.

Definisce il valore della stringa di connessione. Il valore può essere una stringa vuota (""). Non viene effettuato alcun controllo per verificarne la validità.

Il valore predefinito è una stringa vuota ("").

name

Attributo String obbligatorio.

Definisce la chiave da utilizzare per accedere al valore della stringa di connessione. Questo attributo esegue l'override di qualsiasi chiave ereditata con lo stesso nome.

Il valore predefinito è una stringa vuota ("").

providerName

Attributo String facoltativo.

Nome del provider ADO.NET da utilizzare per accedere all'archivio dati sottostante.

Il valore predefinito è "System.Data.SqlClient".

Attributi ereditati

Attributi facoltativi.

Attributi ereditati da tutti gli elementi della sezione.

Per ulteriori informazioni, vedere Attributi generali ereditati da elementi di sezioni.

Elementi figlio

Nessuno.

Elementi padre

Elemento

Descrizione

configuration

Specifica l'elemento di primo livello necessario in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.

system.web

Specifica l'elemento di primo livello per le impostazioni di configurazione ASP.NET in un file di configurazione e contiene gli elementi che consentono di configurare le applicazioni Web ASP.NET e di controllarne il comportamento.

connectionStrings

Specifica un insieme di stringhe di connessione al database, come coppie di nome e valore, per le applicazioni e per le funzionalità ASP.NET.

Note

L'elemento add aggiunge una stringa di connessione come coppia di nome e valore all'insieme di stringhe di connessione nell'elemento connectionStrings.

L'elemento connectionStrings specifica un insieme di stringhe di connessione al database, come coppie di nome e valore, per le applicazioni e per le funzionalità ASP.NET.

Configurazione predefinita

Le stringhe di connessione contenute in un file di configurazione padre vengono ereditate, a meno che l'elemento clear non venga utilizzato nel file di configurazione figlio. Nel file Machine.config viene configurato l'elemento element predefinito seguente:

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

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come configurare una stringa di connessione per un'applicazione che utilizza il database Northwind.

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

Informazioni sull'elemento

Gestore della sezione di configurazione

ConnectionStringsSection

Membro di configurazione

Add(ConnectionStringSettings)

Percorsi configurabili

Machine.config

Web.config a livello di radice

Web.config a livello di applicazione

Web.config a livello di directory fisica o virtuale

Requisiti

Microsoft Internet Information Services (IIS) versione 5.0, 5.1 o 6.0

.NET Framework versione 2.0

Microsoft Visual Studio 2003 o Visual Studio 2005

Vedere anche

Attività

Procedura: bloccare le impostazioni di configurazione di ASP.NET

Concetti

Cenni preliminari sulla configurazione di ASP.NET

Protezione della configurazione di ASP.NET

Cenni preliminari sull'accesso ai dati ASP.NET

Protezione dell'accesso ai dati

Scenari di configurazione ASP.NET

Riferimenti

Elemento clear per connectionStrings (schema delle impostazioni ASP.NET)

Elemento configuration (schema delle impostazioni generali)

Elemento clear per connectionStrings (schema delle impostazioni ASP.NET)

Elemento remove per connectionStrings (schema delle impostazioni ASP.NET)