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 |
|
Membro di configurazione |
|
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)