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

Articolo
08/11/2011

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.

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

Attributi ed elementi

Nelle sezioni seguenti vengono illustrati attributi, elementi figlio e 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	Oggetto di 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

Condividi tramite