Elemento connectionStrings (schema delle impostazioni ASP.NET)
Aggiornamento: novembre 2007
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.
Elemento configuration (schema delle impostazioni generali)
Elemento connectionStrings (schema delle impostazioni ASP.NET)
<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.
Elementi figlio
Elemento |
Descrizione |
|---|---|
Add |
Aggiunge una stringa di connessione come coppia di nome/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 |
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 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
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 di applicazioni per SQL Server
Protezione dell'accesso ai dati
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)