Elemento connectionStrings (schema delle impostazioni ASP.NET)
[Questa documentazione ha solo scopo di anteprima ed è soggetta a modifiche nelle versioni successive. Gli argomenti vuoti sono inclusi come segnaposto.]
Specifica una raccolta di stringhe di connessione al database, come coppie di nome e valore, per le applicazioni e per le funzionalità ASP.NET.
Questo elemento è nuovo in .NET Framework versione 2.0.
<connectionStrings >
<add />
<clear />
<remove />
</connectionStrings>
Attributi ed elementi
Le seguenti sezioni illustrano attributi, elementi figlio e padre per questo elemento.
Attributi
Nessuno tranne gli attributi ereditati da tutti gli elementi della sezione. Per ulteriori informazioni, vedere Attributi generali ereditati da elementi di sezioni. n applicazioni ASP.NET, in fase di esecuzione, è possibile assegnare all'attributo ConfigSource il nome di un file di configurazione alternativo. In questo caso, il contenuto del file viene sovrascritto dalle informazioni della stringa di connessione predefinite, contenute nel file Web.config. Ciò si verifica anche quando il file alternativo non esiste e viene creato in fase di esecuzione. Se il file Web.config non contiene informazioni sulla stringa di collegamento, al file alternativo viene aggiunta una sezione connectionStrings vuota.
Elementi figlio
Elemento |
Descrizione |
|---|---|
Add |
Aggiunge una stringa di connessione come coppia di nome e valore alla raccolta di stringhe di connessione. |
Clear |
Rimuove tutti i riferimenti alle stringhe di connessione ereditate consentendo solo quelli aggiunti dall'elemento add corrente. |
remove |
Rimuove dalla raccolta di stringhe di connessione un riferimento a una stringa di connessione ereditata. |
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. |
Note
L'elemento connectionStrings specifica una raccolta di stringhe di connessione al database, come coppie di nome e valore, per le applicazioni e per le funzionalità ASP.NET.
Nelle precedenti versioni di ASP.NET le stringhe di connessione vengono memorizzate in appSettings. In ASP.NET 2.0 funzionalità, quali Sessione, Appartenenza, Personalizzazione e Gestione ruoli, si basano sulle stringhe di connessione memorizzate nell'elemento connectionStrings. È inoltre possibile utilizzare l'elemento connectionStrings per memorizzare le stringhe di connessione relative alla propria applicazione.
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 connectionStrings predefinito seguente:
È possibile accedere all'elemento connectionStrings a livello di codice. Per ulteriori informazioni, vedere l'esempio ConnectionStrings.
<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 due stringhe di connessione. La prima stringa di connessione può essere utilizzata in un'applicazione ASP.NET, mentre la seconda stringa di connessione viene utilizzata dall'elemento sqlCacheDependency che viene configurato in un momento successivo.
<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>
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à
How to: Lock ASP.NET Configuration Settings
Riferimenti
Elemento configuration (schema delle impostazioni generali)
Elemento add per connectionStrings (schema delle impostazioni ASP.NET)
Elemento clear per connectionStrings (schema delle impostazioni ASP.NET)
Elemento remove per connectionStrings (schema delle impostazioni ASP.NET)
Concetti
ASP.NET Configuration Overview
Installing the SQL Server Provider Database