Stringhe di connessione (Entity Framework)

Una stringa di connessione contiene informazioni di inizializzazione che vengono passate come parametro da un provider di dati a un'origine dati. La sintassi dipende dal provider di dati e la stringa di connessione viene analizzata durante il tentativo di aprire una connessione. Le stringhe di connessione utilizzate da Entity Framework contengono informazioni che consentono di connettersi al provider di dati ADO.NET sottostante che supporta Entity Framework, nonché informazioni sui file di modello e di mapping richiesti.

La stringa di connessione viene utilizzata dal provider EntityClient quando si accede ai metadati di modello e di mapping e quando si effettua la connessione all'origine dati. Per impostare o accedere alla stringa di connessione, utilizzare la proprietà ConnectionString di EntityConnection. La classe EntityConnectionStringBuilder può essere utilizzata a livello di codice per costruire o accedere ai parametri nella stringa di connessione. Per ulteriori informazioni, vedere Procedura: compilare una stringa di connessione EntityConnection (Entity Framework).

Gli strumenti di Entity Data Model consentono di generare una stringa di connessione che viene archiviata nel file di configurazione dell'applicazione. L'oggetto ObjectContext consente di recuperare automaticamente queste informazioni di connessione quando si creano query di oggetto. È possibile accedere all'oggetto EntityConnection utilizzato da un'istanza di ObjectContext direttamente dalla proprietà Connection. Per ulteriori informazioni, vedere Gestione di connessioni e transazioni (Entity Framework).

Parametri della stringa di connessione

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;

Il segno di uguale (=) connette ogni parola chiave al relativo valore. Le parole chiave non fanno distinzione tra maiuscole e minuscole e gli spazi tra coppie chiave/valore vengono ignorati. È tuttavia possibile che tale distinzione sia valida per i valori, a seconda dell'origine dati. I valori contenenti punto e virgola, virgolette singole o virgolette doppie devono essere racchiusi tra virgolette doppie. Nella tabella seguente sono inclusi i nomi validi per i valori di parola chiave nella proprietà ConnectionString.

Parola chiave	Descrizione
Provider	Obbligatoria se la parola chiave Name non è specificata. Nome del provider utilizzato per recuperare l'oggetto DbProviderFactory per il provider sottostante. Questo valore è costante. Quando la parola chiave Name non è inclusa in una stringa di connessione di entità, per la parola chiave Provider è necessario specificare un valore non vuoto. Questa parola chiave e la parola chiave Name si escludono a vicenda.
Provider Connection String	Facoltativa. Indica la stringa di connessione specifica del provider passata all'origine dati sottostante. Questa stringa di connessione viene espressa utilizzando coppie parola chiave/valore valide per il provider di dati. Una parola chiave Provider Connection String non valida produrrà un errore di runtime quando viene valutata dall'origine dati. Questa parola chiave e la parola chiave Name si escludono a vicenda. Il valore della parola chiave Provider Connection String deve essere racchiuso tra virgolette. Di seguito è riportato un esempio: Provider Connection String ="Server=serverName; User ID = userID"; L'esempio seguente è destinato a non funzionare: Provider Connection String =Server=serverName; User ID = userID
Metadata	Obbligatoria se la parola chiave Name non è specificata. Elenco di percorsi di directory, file e risorse delimitato da barre verticali in cui cercare informazioni relative a metadati e mapping. Di seguito è riportato un esempio: Metadata= c:\model | c:\model\sql\mapping.msl; Gli spazi vuoti a ogni lato del separatore barra verticale vengono ignorati. Questa parola chiave e la parola chiave Name si escludono a vicenda.
Name	L'applicazione può eventualmente specificare il nome della connessione in un file di configurazione dell'applicazione che fornisce i valori della stringa di connessione parola chiave/valore obbligatori. In questo caso, non è possibile specificare tali valori direttamente nella stringa di connessione. L'utilizzo della parola chiave Name non è consentito in un file di configurazione. Quando la parola chiave Name non è inclusa nella stringa di connessione, per la parola chiave Provider è necessario specificare valori non vuoti. Questa parola chiave e tutte le altre parole chiave per la stringa di connessione si escludono a vicenda.

Quello che segue è un esempio di stringa di connessione per il modello Sales di AdventureWorks archiviato nel file di configurazione dell'applicazione:

<connectionStrings>
    <add name="AdventureWorksEntities" 
         connectionString="metadata=.\AdventureWorks.csdl|.\AdventureWorks.ssdl|.\AdventureWorks.msl;
         provider=System.Data.SqlClient;provider connection string='Data Source=localhost;
         Initial Catalog=AdventureWorks;Integrated Security=True;Connection Timeout=60;
         multipleactiveresultsets=true'" providerName="System.Data.EntityClient" />
</connectionStrings>

Percorsi dei file di modello e di mapping

Il parametro Metadata contiene un elenco di percorsi in cui il provider EntityClient può eseguire una ricerca di file di modello e di mapping. I file di modello e di mapping spesso sono distribuiti nella stessa directory del file eseguibile dell'applicazione. Tali file possono essere distribuiti anche in un percorso specifico o inclusi come risorse incorporate nell'applicazione.

Le risorse incorporate vengono specificate nel modo seguente:

Metadata=res://<assemblyFullName>/<resourceName>. 

Per la definizione del percorso di una risorsa incorporata, sono disponibili le opzioni seguenti:

Opzione	Descrizione
assemblyFullName	Nome completo di un assembly con la risorsa incorporata. Include il nome semplice, il nome della versione, la lingua supportata e la chiave pubblica, nel modo seguente: ResourceLib, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null Le risorse possono essere incorporate in qualsiasi assembly accessibile dall'applicazione. Se si specifica un carattere jolly (*) per assemblyFullName, il runtime di Entity Framework cercherà le risorse nei percorsi seguenti, in questo ordine: L'assembly chiamante. Gli assembly a cui si fa riferimento. Gli assembly nella directory bin di un'applicazione. Se i file non sono in uno di questi percorsi, verrà generata un'eccezione. Nota: Quando si utilizza un carattere jolly (*), la ricerca di risorse con il nome corretto deve essere eseguita in tutti gli assembly.Per migliorare le prestazioni, specificare il nome dell'assembly anziché il carattere jolly.
resourceName	Nome della risorsa inclusa, ad esempio AdvendtureWorksModel.csdl. I servizi di metadati cercheranno solo i file o le risorse con estensione csdl, ssdl o msl. Se la parola chiave resourceName non è specificata, verranno caricate tutte le risorse dei metadati. Le risorse devono disporre di nomi univoci all'interno di un assembly. Se più file con lo stesso nome sono definiti in directory diverse nell'assembly, la parola chiave resourceName deve includere la struttura di cartelle prima del nome della risorsa, ad esempio NomeCartella.NomeFile.csdl. resourceName non è obbligatoria quando si specifica un carattere jolly (*) per assemblyFullName.

Nota:
Per migliorare le prestazioni, incorporare le risorse nell'assembly chiamante, ad eccezione degli scenari non Web in cui non è presente alcun riferimento ai file di mapping e di metadati sottostanti nell'assembly chiamante.

Nell'esempio seguente vengono caricati tutti i file di modello e di mapping nell'assembly chiamante, gli assembly a cui si fa riferimento e gli altri assembly nella directory bin di un'applicazione.

Metadata=res://*/

Nell'esempio seguente viene caricato il file model.csdl dell'assembly AdventureWorks e vengono caricati i file model.ssdl e model.msl dalla directory predefinita dell'applicazione in esecuzione.

Metadata=res://AdventureWorks, 1.0.0.0, neutral, a14f3033def15840/model.csdl|model.ssdl|model.msl

Nell'esempio seguente sono caricate le tre risorse specificate dall'assembly specifico.

Metadata=res://AdventureWorks, 1.0.0.0, neutral, a14f3033def15840/model.csdl| 
res://AdventureWorks, 1.0.0.0, neutral, a14f3033def15840/model.ssdl| 
res://AdventureWorks, 1.0.0.0, neutral, a14f3033def15840/model.msl

Nell'esempio seguente sono caricate tutte le risorse incorporate con estensioni csdl, msl e ssdl dall'assembly.

Metadata=res://AdventureWorks, 1.0.0.0, neutral, a14f3033def15840/

Nell'esempio seguente vengono caricate tutte le risorse nel percorso del file relativo oltre a "datadir\metadata \" dal percorso dell'assembly caricato.

Metadata=datadir\metadata\

Nell'esempio seguente vengono caricate tutte le risorse nel percorso del file relativo provenienti dal percorso dell'assembly caricato.

Metadata=.  \  

Supporto per la stringa di sostituzione | DataDirectory | e l'operatore radice dell'applicazione Web (~)

DataDirectory e l'operatore ~ vengono utilizzati nella proprietà ConnectionString come parte delle parole chiave Metadata e Provider Connection String. EntityConnection inoltra DataDirectory e l'operatore ~ rispettivamente a MetadataWorkspace e al provider di archiviazione.

Termine	Descrizione
|DataDirectory|	Si risolve in un percorso relativo di file di mapping e di metadati. Si tratta del valore impostato attraverso il metodo AppDomain.SetData("DataDirectory", objValue). La stringa di sostituzione DataDirectory deve essere circondata dai caratteri barra verticale e non può essere essere rappresentata da uno spazio vuoto tra il nome e i caratteri barra verticale. Il nome DataDirectory non supporta la distinzione tra maiuscole e minuscole. Se una directory fisica denominata "DataDirectory" deve essere passata come membro dell'elenco di percorsi di metadati, aggiungere uno spazio vuoto su un lato o su entrambi i lati del nome, ad esempio: Metadata="DataDirectory1 | DataDirectory | DataDirectory2". Un'applicazione ASP.NET risolve | DataDirectory | nella cartella "<application root>/app_data".
~	Si risolve nella radice dell'applicazione Web. Il carattere ~ in una posizione iniziale viene sempre interpretato come l'operatore radice dell'applicazione Web (~), sebbene possa rappresentare una sottodirectory locale valida. Per fare riferimento a questo tipo di sottodirectory locale, l'utente deve passare in modo esplicito ./~.

DataDirectory e l'operatore ~ devono essere specificati solo all'inizio di un percorso in quanto non vengono risolti in altre posizioni. Entity Framework tenterà di risolvere ~/data, ma considererà /data/~ come un percorso fisico.

Un percorso che inizia con DataDirectory o con l'operatore ~ non può essere risolto in un percorso fisico al di fuori del ramo di DataDirectory e dell'operatore ~. Ad esempio, i percorsi seguenti risolveranno: ~ , ~/data , ~/bin/Model/SqlServer. I percorsi seguenti non riusciranno a risolvere: ~/.., ~/../other.

DataDirectory e l'operatore ~ possono essere estesi per includere sottodirectory, nel modo seguente: |DataDirectory|\Model, ~/bin/Model

La risoluzione della stringa di sostituzione DataDirectory e l'operatore ~ è non ricorsiva. Ad esempio, quando DataDirectory include il carattere ~, si verificherà un'eccezione. In questo modo viene impedita una ricorsione infinita.

Vedere anche

Concetti

Considerazioni relative alla distribuzione (Entity Framework)
Gestione di connessioni e transazioni (Entity Framework)

Altre risorse

Utilizzo di provider di dati (Entity Framework)
Connection Strings (ADO.NET)