Elemento connectionStrings (schema delle impostazioni ASP.NET)
Specifica un insieme 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 |
Oggetto di descrizione |
|---|---|
Add |
Aggiunge una stringa di connessione come coppia di nome e valore all'insieme di stringhe di connessione. |
Clear |
Rimuove tutti i riferimenti alle stringhe di connessione ereditate consentendo solo quelli aggiunti dall'elemento add corrente. |
remove |
Rimuove dall'insieme di stringhe di connessione un riferimento a una stringa di connessione ereditata. |
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 per la configurazione di applicazioni Web ASP.NET e il controllo del comportamento delle stesse. |
Note
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.
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à
Procedura: bloccare le impostazioni di configurazione di ASP.NET
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
Cenni preliminari sulla configurazione di ASP.NET
Protezione della configurazione di ASP.NET
Cenni preliminari sull'accesso ai dati ASP.NET
Creazione del database dei servizi per le applicazioni per SQL Server
Protezione dell'accesso ai dati