Il formato di una stringa di connessione è un elenco delimitato da punti e virgola composto da coppie di parametri chiave/valore:

keyword1=value; keyword2=value

Gli spazi sono ignorati e per le parole chiave non viene rilevata la differenza tra maiuscole e minuscole. Per i valori, invece, tale differenza può essere rilevata a seconda dell'origine dati. Per inserire valori che contengono punto e virgola, virgolette singole o virgolette doppie, è necessario racchiuderli tra virgolette doppie.

La sintassi di una stringa di connessione valida varia a seconda del provider e, nel corso degli anni, si è evoluta dalle API iniziali quali ODBC. Il provider di dati .NET Framework per SQL Server incorpora molti elementi della sintassi precedente e, in genere, presenta una sintassi della stringa di connessione comune più flessibile. Per ulteriori informazioni sulle parole chiave delle stringhe di connessione per i provider di dati .NET, vedere ConnectionString, ConnectionString, ConnectionString e ConnectionString.

L'impostazione predefinita per la parola chiave Persist Security Info in una stringa di connessione è false.

Persist Security Info=false;

Se si imposta la parola chiave su true o yes, sarà possibile ottenere informazioni riservate, compresi l'ID utente e la password, dalla connessione dopo che questa è stata aperta. Se è necessario fornire l'ID utente e la password quando si effettua una connessione, si otterrà il massimo livello di protezione se tali informazioni verranno eliminate dopo che sono state utilizzate per la connessione, ad esempio quando Persist Security Info è impostato su false o su no. Tale scelta diventa ancora più importante se si fornisce una connessione aperta a una fonte non attendibile o se le informazioni di connessione sono conservate sul disco. Se si imposta Persist Security Info su false, si impedisce che la fonte non attendibile abbia accesso alle informazioni riservate relative alla connessione e si assicura inoltre che le informazioni riservate non verranno salvate su disco insieme alla stringa di connessione.

Si consiglia di utilizzare l'autenticazione Windows, definita in genere protezione integrata, per eseguire la connessione ai database dei server. Per specificare l'autenticazione Windows, è possibile utilizzare una delle seguenti coppie chiave/valore con il provider di dati .NET Framework per SQL Server:

Integrated Security=true;
Integrated Security=SSPI;

Tuttavia, solo la seconda funzionerà con il provider di dati .NET Framework per OleDb. Se si imposta Integrated Security=true in una proprietà ConnectionString, verrà generata un'eccezione.

Per specificare l'autenticazione Windows, è necessario utilizzare la seguente coppia chiave/valore per il provider di dati .NET Framework per ODBC.

Trusted_Connection=yes;

Ogni provider di dati .NET Framework fornisce una classe del generatore di stringhe di connessione tipizzata in modo sicuro, la quale eredita dal tipo DbConnectionStringBuilder. I generatori di stringhe di connessione consentono agli sviluppatori di creare a livello di codice stringhe di connessione sintatticamente corrette sulla base di input dell'utente, nonché di analizzare e ricreare stringhe di connessione esistenti. Per ulteriori informazioni, vedere SqlConnectionStringBuilder, OleDbConnectionStringBuilder, OdbcConnectionStringBuilder e OracleConnectionStringBuilder.

Si consiglia di non incorporare stringhe di connessione nel codice. Se la posizione del server viene modificata, è necessario compilare nuovamente l'applicazione. Inoltre, le stringhe di connessione non crittografate compilate in un codice sorgente dell'applicazione possono essere visualizzate con Disassembler MSI (ildasm.exe).

Archiviazione di stringhe di connessione in file di configurazione

<connectionStrings>
    <add name="DatabaseConnection" 
        connectionString="Persist Security Info=False;Integrated Security=SSPI;database=Northwind;server=(local);"
         providerName="System.Data.SqlClient" />
</connectionStrings>

Recupero di stringhe di connessione da file di configurazione

Lo spazio dei nomi System.Configuration fornisce le classi da utilizzare con le informazioni di configurazione archiviate nei file di configurazione. Per la classe ConnectionStringSettings sono disponibili due proprietà che sono associate ai nomi indicati in precedenza nella sezione di esempio <connectionStrings>.

ConnectionString

Stringa di connessione.

Name

Nome della stringa di connessione nella sezione <connectionStrings>.

Nota sulla protezione

È possibile utilizzare la configurazione protetta per crittografare, se necessario, le stringhe di connessione archiviate in file di configurazione. Vedere Crittografia delle informazioni di configurazione utilizzando la configurazione protetta, Encrypting and Decrypting Configuration Sections e Procedura dettagliata: crittografia delle informazioni di configurazione utilizzando la configurazione protetta.

Esempio

Option Explicit On
Option Strict On

Imports System.Configuration

Module Module1
    Sub Main()
        Dim settings As ConnectionStringSettings
        settings = _
           ConfigurationManager.ConnectionStrings("DatabaseConnection")
        If Not settings Is Nothing Then
            Console.WriteLine(settings.ConnectionString)
        End If
    End Sub
End Module

using System;
using System.Configuration;

class Program
{
    static void Main()
    {
        ConnectionStringSettings settings;
        settings = 
            ConfigurationManager.ConnectionStrings["DatabaseConnection"];
        if (settings != null)
        {
            Console.WriteLine(settings.ConnectionString);
        }
    }
}

La proprietà ConnectionString di una SqlConnection consente di recuperare o impostare una stringa di connessione per un database SQL Server 7.0 o versione successiva. Per eseguire la connessione a una versione precedente di SQL Server, utilizzare il provider di dati .NET per OleDb.

Sintassi della stringa di connessione SqlClient

"Persist Security Info=False;Integrated Security=true;Initial Catalog=AdventureWorks;Server=MSSQL1"
"Persist Security Info=False;Integrated Security=SSPI;database=AdventureWorks;server=(local)"
"Persist Security Info=False;Trusted_Connection=True;database=AdventureWorks;server=(local)"

"Persist Security Info=False;User ID=*****;Password=*****;Initial Catalog=AdventureWorks;Server=MySqlServer"

Connessione a istanze denominate

Server=MySqlServer\MSSQL1;"

Impostazione della libreria di rete

Network Library=dbmssocn;Data Source=000.000.000.000,1433;

La proprietà ConnectionString di un tipo OleDbConnection consente di recuperare o impostare una stringa di connessione per un'origine dati OLE DB quale Microsoft Access o SQL Server 6.5 o versioni precedenti. Utilizzare un tipo SqlConnection per SQL Server 7.0 o versioni successive.

Sintassi della stringa di connessione OleDb

Provider=Microsoft.Jet.OLEDB.4.0; Data Source=d:\Northwind.mdb;User ID=Admin;Password=; 

Provider=Microsoft.Jet.OLEDB.4.0;Data Source=d:\Northwind.mdb;Jet OLEDB:System Database=d:\NorthwindSystem.mdw;User ID=*****;Password=*****;

Provider=sqloledb;Data Source=MySqlServer;Initial Catalog=pubs;User Id=*****;Password=*****;

È possibile fornire informazioni di connessione per un oggetto OleDbConnection in un file UDL (Universal Data Link). Si consiglia, tuttavia, di evitare questa procedura. I file UDL non sono crittografati, pertanto espongono le informazioni nella stringa di connessione come testo non crittografato. Poiché per l'applicazione si tratta di una risorsa esterna basata su file, un file UDL non può essere protetto tramite .NET Framework.

Connessione a Excel

Provider=Microsoft.Jet.OLEDB.4.0;Data Source=D:\MyExcel.xls;Extended Properties=""Excel 8.0;HDR=Yes;IMEX=1""

Sintassi della stringa di connessione di Data Shape Provider

"Provider=MSDataShape;Data Provider=SQLOLEDB;Data Source=(local);Initial Catalog=pubs;Integrated Security=SSPI;" 

La proprietà ConnectionString di un tipo OdbcConnection consente di ottenere o impostare una stringa di connessione per un'origine dati OLE DB. Nella seguente stringa di connessione viene utilizzato il driver Microsoft per file di testo.

Driver={Microsoft Text Driver (*.txt; *.csv)};DBQ=d:\bin

Per ulteriori informazioni sulla sintassi della stringa di connessione ODBC, vedere ConnectionString.

La proprietà ConnectionString di un tipo OracleConnection consente di recuperare o impostare una stringa di connessione per un'origine dati OLE DB.

Data Source=Oracle9i;User ID=*****;Password=*****;

Per ulteriori informazioni sulla sintassi della stringa di connessione ODBC, vedere ConnectionString.

Concetti