Condividi tramite


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

ConnectionStringsSection

Membro di configurazione

ConnectionStringSettingsCollection

ConnectionStrings

ConnectionStrings

ConnectionStrings

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

Altre risorse

Impostazioni di configurazione di ASP.NET