SqlConnection.ConnectionString Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta la stringa usata per aprire un database di SQL Server.
public:
virtual property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.SettingsBindable(true)]
public override string ConnectionString { get; set; }
public override string ConnectionString { get; set; }
[<System.ComponentModel.SettingsBindable(true)>]
member this.ConnectionString : string with get, set
member this.ConnectionString : string with get, set
Public Overrides Property ConnectionString As String
Valore della proprietà
Stringa di connessione che contiene il nome del database di origine e altri parametri necessari a stabilire la connessione iniziale. Il valore predefinito è una stringa vuota.
- Attributi
Eccezioni
È stato fornito un argomento stringa di connessione non valido o non è stato specificato un argomento stringa di connessione richiesto.
Esempio
Nell'esempio seguente viene creato un SqlConnection oggetto e viene impostata la ConnectionString proprietà prima di aprire la connessione.
using Microsoft.Data.SqlClient;
class Program
{
static void Main()
{
OpenSqlConnection();
Console.ReadLine();
}
private static void OpenSqlConnection()
{
string connectionString = GetConnectionString();
using (SqlConnection connection = new SqlConnection())
{
connection.ConnectionString = connectionString;
connection.Open();
Console.WriteLine("State: {0}", connection.State);
Console.WriteLine("ConnectionString: {0}",
connection.ConnectionString);
}
}
static private string GetConnectionString()
{
// To avoid storing the connection string in your code,
// you can retrieve it from a configuration file.
return "Data Source=MSSQL1;Initial Catalog=AdventureWorks;"
+ "Integrated Security=true;";
}
}
Commenti
L'oggetto ConnectionString è simile a un stringa di connessione OLE DB, ma non è identico. A differenza di OLE DB o ADO, la stringa di connessione restituita è uguale a quella impostata ConnectionStringdall'utente, meno le informazioni di sicurezza se il valore Persistent Security Info è impostato su false
(impostazione predefinita). Il provider di dati .NET Framework per SQL Server non persiste o restituisce la password in un stringa di connessione a meno che non si impostaNo informazioni di sicurezza persistenti su true
.
È possibile usare la ConnectionString proprietà per connettersi a un database. Nell'esempio seguente viene illustrato un stringa di connessione tipico.
"Persist Security Info=False;Integrated Security=true;Initial Catalog=Northwind;server=(local)"
Usare il nuovo SqlConnectionStringBuilder per costruire stringhe di connessione valide in fase di esecuzione. Per altre informazioni, vedere Compilatori di stringhe di connessione.
La ConnectionString proprietà può essere impostata solo quando la connessione viene chiusa. Molti dei valori stringa di connessione hanno proprietà di sola lettura corrispondenti. Quando viene impostata la stringa di connessione, queste proprietà vengono aggiornate, tranne quando viene rilevato un errore. In questo caso, nessuno delle proprietà viene aggiornato. SqlConnection le proprietà restituiscono solo le impostazioni contenute in ConnectionString.
Per connettersi a un computer locale, specificare "(local)" per il server. Se non è specificato un nome del server, verrà tentata una connessione all'istanza predefinita nel computer locale.
La reimpostazione di ConnectionString in una connessione chiusa reimposta tutti i valori stringa di connessione (e le proprietà correlate) incluse la password. Ad esempio, se si imposta un stringa di connessione che include "Database= AdventureWorks" e quindi reimpostare il stringa di connessione su "Origine dati=myserver; Integrated Security=true, la Database proprietà non è più impostata su "AdventureWorks".
Il stringa di connessione viene analizzato immediatamente dopo essere stato impostato. Se vengono trovati errori nella sintassi durante l'analisi, viene generata un'eccezione di runtime, ad esempio ArgumentException, . È possibile trovare altri errori solo quando viene eseguito un tentativo di apertura della connessione.
Il formato di base di un stringa di connessione include una serie di coppie chiave/valore separate da punti e virgola. Il segno di uguale (=) connette ogni parola chiave al relativo valore. Per includere valori contenenti un punto e virgola, un carattere di virgolette singole o un carattere di virgolette doppie, il valore deve essere racchiuso tra virgolette doppie. Se il valore contiene sia un punto e virgola che un carattere di virgolette doppie, il valore può essere racchiuso tra virgolette singole. La virgolette singola è utile anche se il valore inizia con un carattere di virgolette doppie. Al contrario, la virgoletta doppia può essere usata se il valore inizia con una virgoletta singola. Se il valore contiene sia virgolette singole che virgolette doppie, il carattere di virgolette utilizzato per racchiudere il valore deve essere raddoppiato ogni volta che si verifica all'interno del valore.
Per includere spazi precedenti o finali nel valore stringa, il valore deve essere racchiuso tra virgolette singole o virgolette doppie. Tutti gli spazi iniziali o finali intorno a valori integer, booleani o enumerati vengono ignorati, anche se racchiusi tra virgolette. Tuttavia, gli spazi all'interno di una parola chiave letterale stringa o valore vengono mantenuti. Le virgolette singole o doppie possono essere usate all'interno di un stringa di connessione senza usare delimitatori (ad esempio, Origine dati= my'Server o Origine dati= my"Server), a meno che un carattere di virgolette non sia il primo o l'ultimo carattere nel valore.
Le parole chiave non sono distinzione tra maiuscole e minuscole.
Nella tabella seguente sono elencati i nomi validi per i valori delle parole chiave all'interno di ConnectionString.
Parola chiave | Predefinito | Descrizione |
---|---|---|
Addr | N/D | Sinonimo dell'origine dati. |
Indirizzo | N/D | Sinonimo dell'origine dati. |
App | N/D | Sinonimo del nome applicazione. |
Finalità dell'applicazione -oppure- ApplicationIntent |
ReadWrite | Dichiara il tipo di carico di lavoro dell'applicazione in caso di connessione a un server. I valori possibili sono ReadOnly e ReadWrite . Ad esempio:ApplicationIntent=ReadOnly Per altre informazioni sul supporto SqlClient per gruppi di disponibilità Always On, vedere Supporto SqlClient per disponibilità elevata, ripristino di emergenza. |
Nome dell'applicazione | N/D | Nome dell'applicazione. Se non viene specificato alcun nome dell'applicazione, 'Framework Microsoft SqlClient Data Provider' quando è in esecuzione in .NET Framework e 'Core Microsoft SqlClient Data Provider' in caso contrario. Un nome applicazione può essere di 128 caratteri o meno. |
AttachDBFilename -oppure- Extended Properties -oppure- Nome file iniziale |
N/D | Nome del file di database primario, incluso il nome completo del percorso di un database collegato. AttachDBFilename è supportata solo per i file di dati primari con estensione mdf. Se il valore della chiave AttachDBFileName viene specificato nella stringa di connessione, il database viene collegato e diventa il database predefinito per la connessione. Se questa chiave non è specificata e se il database è stato collegato in precedenza, il database non verrà riattaccato. Il database collegato in precedenza verrà usato come database predefinito per la connessione. Se questa chiave viene specificata insieme alla chiave AttachDBFileName, il valore di questa chiave verrà usato come alias. Tuttavia, se il nome è già usato in un altro database collegato, la connessione avrà esito negativo. Il percorso può essere assoluto o relativo usando la stringa di sostituzione di DataDirectory. Se viene usato DataDirectory, il file di database deve esistere all'interno di una sottodirectory della directory a cui punta la stringa di sostituzione. Nota: I nomi dei percorsi UNC, HTTP e SERVER remoti non sono supportati. Il nome del database deve essere specificato con la parola chiave 'database' (o uno dei relativi alias) come indicato di seguito: "AttachDbFileName=|DataDirectory|\data\YourDB.mdf;integrated security=true;database=YourDatabase" Verrà generato un errore se esiste un file di log nella stessa directory del file di dati e viene utilizzata la parola chiave 'database' quando ci si collega al file di dati primario. In questo caso, rimuovere il file di log. Una volta collegato il database, verrà automaticamente generato un nuovo file di log in base al percorso fisico. |
Protocollo di attestazione | NotSpecified | Ottiene o imposta il valore del protocollo di attestazione. Quando non viene specificato alcun valore, le enclave sicure vengono disabilitate nella connessione. I valori validi sono: AAS HGS None (valido solo in v3.1 e v4.1+)) |
Authentication | N/D | Metodo di autenticazione usato per La connessione a database SQL tramite l'autenticazione di Azure Active Directory. I valori validi sono: Active Directory Integrated , Active Directory Interactive , Active Directory Password , Active Directory Service Principal , Active Directory Device Code Flow , Active Directory Managed Identity , Active Directory MSI , Active Directory Default , Sql Password .Per altre informazioni, vedere Uso dell'autenticazione di Azure Active Directory con SqlClient. |
Impostazione di crittografia di colonna | disabled | Abilita o disabilita Always Encrypted funzionalità per la connessione. I valori supportati sono: enabled e disabled |
Timeout comando | 30 | Tempo di attesa predefinito (in secondi) prima di terminare il tentativo di eseguire un comando e generare un errore. I valori validi sono maggiori o uguali a 0 e minori o uguali a 2147483647. |
Numero di tentativi di connessione -oppure- ConnectRetryCount |
1 | Controlla il numero di tentativi di riconnessione dopo che il client identifica un errore di connessione inattivo. I valori validi sono da 0 a 255. 0 significa non tentare di riconnettersi (disabilitare la resilienza della connessione). Nota: poiché la versione 5.x il valore predefinito per gli endpoint non di Azure è 1. Per gli endpoint Azure SQL, il valore predefinito è 2. Per Azure SQL endpoint serverless o su richiesta, il valore predefinito è 5 per migliorare l'esito positivo della connessione per le connessioni a un'istanza inattiva o sospesa. Per altre informazioni sulla resilienza della connessione inattiva, vedere parametri .NET SqlConnection per i tentativi di connessione e l'articolo tecnico - Resilienza di connessione inattiva. |
Intervallo dei tentativi di connessione -oppure- ConnectRetryInterval |
10 | Specifica il tempo tra ogni tentativo di ripetizione della connessione (ConnectRetryCount ). I valori validi sono da 1 a 60 secondi (default=10), applicati dopo il primo tentativo di riconnessione. Quando viene rilevata una connessione interrotta, il client tenta immediatamente di riconnettersi; si tratta del primo tentativo di riconnessione e si verifica solo se ConnectRetryCount è maggiore di 0. Se il primo tentativo di riconnessione ha esito negativo e ConnectRetryCount è maggiore di 1, il client attende ConnectRetryInterval di provare il secondo e i tentativi di riconnessione successivi.Per altre informazioni sulla resilienza della connessione inattiva, vedere Parametri sqlConnection per i tentativi di connessione e l'articolo tecnico - Resilienza di connessione inattiva. |
Timeout di connessione -oppure- Timeout di connessione -oppure- Timeout |
15 | Tempo di attesa (in secondi) per attendere una connessione al server prima di terminare il tentativo e generare un errore. I valori validi sono maggiori o uguali a 0 e minori o uguali a 2147483647. Quando si apre una connessione a un database Azure SQL, impostare il timeout di connessione su 30 secondi. |
Lingua corrente -oppure- Linguaggio |
N/D | Imposta la lingua utilizzata per gli avvisi del server di database o i messaggi di errore. Il nome della lingua può essere di 128 caratteri o meno. |
origine dati -oppure- Server -oppure- Indirizzo -oppure- Addr -oppure- Indirizzo di rete |
N/D | Nome o indirizzo di rete dell'istanza di SQL Server a cui connettersi. Il numero di porta può essere specificato dopo il nome del server:server=tcp:servername, portnumber Quando si specifica un'istanza locale, usare sempre (locale). Per forzare un protocollo, aggiungere uno dei prefissi seguenti: np:(local), tcp:(local), lpc:(local) È anche possibile connettersi a un database LocalDB come indicato di seguito: server=(localdb)\\myInstance Per altre informazioni su LocalDB, vedere Supporto sqlClient per LocalDB. L'origine dati deve usare il formato TCP o il formato Named Pipe. Il formato TCP è il seguente: - tcp:<host name\<instance name>> - tcp:<host name,TCP></IP port number> Il formato TCP deve iniziare con il prefisso "tcp:" e viene seguito dall'istanza del database, come specificato da un nome host e un nome dell'istanza. Questo formato non è applicabile quando ci si connette a Azure SQL Database. TCP viene selezionato automaticamente per le connessioni a Azure SQL Database quando non viene specificato alcun protocollo. Il nome host DEVE essere specificato in uno dei modi seguenti: - NetBIOSName - IPv4Address - IPv6Address Il nome dell'istanza viene usato per risolvere un determinato numero di porta TCP/IP in cui è ospitata un'istanza di database. In alternativa, specificando direttamente un numero di porta TCP/IP è consentito. Se non sono presenti sia il nome dell'istanza che il numero di porta, viene usata l'istanza predefinita del database. Il formato Named Pipe è il seguente: - np:\<\nome> host\pipe\<nome pipe> Il formato Named Pipe DEVE iniziare con il prefisso "np:" e viene seguito da un nome di pipe denominato. Il nome host DEVE essere specificato in uno dei modi seguenti: - NetBIOSName - IPv4Address - IPv6Address Il nome della pipe viene usato per identificare l'istanza del database a cui si connetterà l'applicazione .NET. Se viene specificato il valore della chiave di rete , non è necessario specificare i prefissi "tcp:" e "np:". Nota: È possibile forzare l'uso di TCP anziché la memoria condivisa, prefissi tcp: al nome del server nella stringa di connessione o tramite localhost. |
Url attestazione dell'enclave | N/D | Ottiene o imposta l'URL di attestazione dell'enclave da usare con Always Encrypted basati sull'enclave. |
Encrypt | 'true' in 4.0 e versioni successive 'false' in 3.x e sotto |
I valori riconosciuti sono: versioni 1 - 4: true /yes e false /no versioni 5+: true /yes mandatory /e . false /no /optional strict Quando true , la crittografia TLS viene usata per tutti i dati inviati tra il client e il server se il server ha un certificato installato. Quando strict viene usata la crittografia TLS TDS 8.0 e l'impostazione TrustServerCertificate viene ignorata e considerata come false. Per altre informazioni, vedere Sintassi della stringa di connessione.Quando Encrypt è o strict TrustServerCertificate è mandatory false , il nome del server (o l'indirizzo IP) nel certificato di un server deve corrispondere esattamente al nome del server (o all'indirizzo IP) specificato nella stringa di connessione. In caso contrario, il tentativo di connessione non riuscirà. |
Inserisci | 'true' | true indica che il pooler di connessione SQL Server inserisce automaticamente la connessione nel contesto di transazione corrente del thread di creazione. |
Partner di failover | N/D | Nome del server partner di failover in cui è configurato il mirroring del database. Se il valore di questa chiave è "", il catalogo iniziale deve essere presente e il relativo valore non deve essere "". Il nome del server può essere di 128 caratteri o meno. Se si specifica un partner di failover, ma il server partner di failover non è configurato per il mirroring del database e il server primario (specificato con la parola chiave Server) non è disponibile, la connessione avrà esito negativo. Se si specifica un partner di failover e il server primario non è configurato per il mirroring del database, la connessione al server primario (specificata con la parola chiave Server) avrà esito positivo se il server primario è disponibile. |
Nome SPN del partner di failover -oppure- FailoverPartnerSPN |
N/D | Nome SPN del partner di failover. Il valore predefinito è una stringa vuota, che fa sì che SqlClient usi il nome SPN predefinito generato dal driver. (disponibile solo nella versione 5.0+) |
Host Name In Certificate -oppure- HostNameInCertificate |
N/D | Nome host da utilizzare per la convalida del certificato del server. Se non specificato, il nome del server dell'origine dati viene usato per la convalida del certificato. (disponibile solo nella versione 5.0+) |
Certificato server -oppure- ServerCertificate |
N/D | Percorso di un file di certificato in base al SQL Server certificato TLS/SSL. I formati di certificato accettati sono PEM, DER e CER. Se specificato, il certificato SQL Server viene controllato verificando se serverCertificate specificato è una corrispondenza esatta. (disponibile solo nella versione 5.1+) |
Catalogo iniziale -oppure- Database |
N/D | Nome del database. Il nome del database può essere di 128 caratteri o meno. |
Sicurezza integrata -oppure- Trusted_Connection |
'false' | Quando false , l'ID utente e la password vengono specificati nella connessione. Quando true , le credenziali dell'account di Windows corrente vengono usate per l'autenticazione.I valori riconosciuti sono , , no , e sspi (fortemente consigliato), che equivale a true . yes false true Se l'ID utente e la password sono specificati e la sicurezza integrata è impostata su true, l'ID utente e la password verranno ignorati e verrà usata la sicurezza integrata. SqlCredentialè un modo più sicuro per specificare le credenziali per una connessione che usa l'autenticazione SQL Server ( Integrated Security=false ). |
Preferenza indirizzo IP -oppure- IPAddressPreference |
IPv4First | Preferenza della famiglia di indirizzi IP quando si stabiliscono connessioni TCP. Se Transparent Network IP Resolution (in .NET Framework) o Multi Subnet Failover è impostato su true, questa impostazione non ha alcun effetto. I valori supportati includono:IPAddressPreference=IPv4First IPAddressPreference=IPv6First IPAddressPreference=UsePlatformDefault |
Timeout bilanciamento del carico -oppure- Durata della connessione |
0 | Quando una connessione viene restituita al pool, l'ora di creazione viene confrontata con l'ora corrente e la connessione viene eliminata definitivamente se l'intervallo è superiore al valore in secondi della durata della connessione specificato da Connection Lifetime . Questa è utile nelle configurazioni cluster per applicare il bilanciamento del carico tra un server in esecuzione e un server appena portato online.Il valore zero (0) fa sì che le connessioni in pool abbiano il timeout di connessione massimo. |
Dimensione max pool | 100 | Numero massimo di connessioni consentite nel pool. I valori validi sono maggiori o uguali a 1. I valori minori di Min Pool Size generano un errore. |
Dimensione min pool | 0 | Numero minimo di connessioni consentite nel pool. I valori validi sono maggiori o uguali a 0. Zero (0) in questo campo indica che inizialmente non vengono aperte connessioni minime. I valori maggiori di Max Pool Size generano un errore. |
Più set di risultati attivi -oppure- MultipleActiveResultSets |
false | Quando true , un'applicazione può mantenere più set di risultati attivi (MARS). Quando false , un'applicazione deve elaborare o annullare tutti i set di risultati da un batch prima di poter eseguire qualsiasi altro batch in tale connessione.I valori riconosciuti sono true e false .Per altre informazioni, vedere MARS (Multiple Active Result Sets). |
Failover su più subnet -oppure- MultiSubnetFailover |
false | Specificare multiSubnetFailover=True sempre quando ci si connette al listener del gruppo di disponibilità di un gruppo di disponibilità SQL Server 2012 (o versione successiva) o a un'istanza del cluster di failover SQL Server 2012 (o versione successiva). multiSubnetFailover=True configura SqlClient per fornire un rilevamento e una connessione più veloci al server attivo (attualmente). I valori possibili sono Yes e e False No True e 1 0 . Ad esempio:MultiSubnetFailover=True Il valore predefinito è False . Per altre informazioni sul supporto di SqlClient per i gruppi di disponibilità di Always On, vedere Supporto di SqlClient per disponibilità elevata e ripristino di emergenza. |
Libreria di rete -oppure- Rete -oppure- Net |
N/D | Libreria di rete utilizzata per stabilire una connessione a un'istanza di SQL Server. I valori supportati includono: dbnmpntw (Named Pipes) dbmsrpcn (Multiprotocol, Windows RPC) dbmsadsn (Apple Talk) dbmsgnet (VIA) dbmslpcn (memoria condivisa) dbmsspxn (IPX/SPX) dbmssocn (TCP/IP) Dbmsvinn (Viti Banyan) È necessario installare il DLL di rete corrispondente sul sistema al quale si esegue la connessione. Se non si specifica una rete e si usa un server locale ,ad esempio "." o "(local)", viene usata la memoria condivisa. In questo esempio la libreria della rete è Win32 Winsock TCP/IP (dbmssocn) e la porta utilizzata è 1433. Network Library=dbmssocn;Data Source=000.000.000.000,1433; |
Dimensione pacchetti | 8000 | Dimensioni in byte dei pacchetti di rete usati per comunicare con un'istanza di SQL Server. La dimensione dei pacchetti può essere maggiore o uguale a 512 e minore o uguale a 32768. |
Password -oppure- PWD |
N/D | Password per l'accesso all'account SQL Server. Non consigliata. Per mantenere un livello elevato di sicurezza, è consigliabile usare invece la Integrated Security parola chiave o Trusted_Connection . SqlCredentialè un modo più sicuro per specificare le credenziali per una connessione che usa SQL Server Autenticazione.La password deve essere di 128 caratteri o meno. |
Persist Security Info -oppure- PersistSecurityInfo |
'false' | Se impostato su o no (fortemente consigliato), le informazioni sensibili alla false sicurezza, ad esempio la password o il token di accesso, non vengono restituite come parte della connessione se la connessione è aperta o è mai stata in uno stato aperto. Questa proprietà deve essere impostata true solo su se l'applicazione ha una necessità specifica di leggere la password fuori da una connessione di database già aperta. Il valore predefinito di è l'impostazione più sicura. L'uso true di false questa proprietà apre l'applicazione ai rischi di sicurezza, ad esempio la registrazione accidentale o la traccia della password del database.Reimpostando l'stringa di connessione vengono reimpostati tutti i valori di stringa di connessione inclusi la password. I valori riconosciuti sono true , false , yes e no . |
Periodo di blocco del pool -oppure- PoolBlockingPeriod |
Auto | Imposta il comportamento del periodo di blocco per un pool di connessioni. Per informazioni dettagliate, vedere la proprietà PoolBlockingPeriod . |
Pooling | 'true' | Quando il valore di questa chiave è impostato su true, qualsiasi connessione appena creata verrà aggiunta al pool quando viene chiusa dall'applicazione. In un tentativo successivo di aprire la stessa connessione, tale connessione verrà disegnata dal pool. Connections vengono considerati gli stessi se hanno lo stesso stringa di connessione. Le diverse connessioni hanno stringhe di connessione diverse. Il valore di questa chiave può essere "true", "false", "sì" o "no". |
Replica | 'false' | true se la replica è supportata usando la connessione. |
SPN server -oppure- ServerSPN |
N/D | SpN per l'origine dati. Il valore predefinito è una stringa vuota, che causa l'uso del nome SPN predefinito generato dal driver SqlClient. (disponibile solo in v5.0+) |
Associazioni transazionali | Implicit Unbind | Controlla l'associazione di connessione con una transazione elencata System.Transactions .I valori possibili sono: Transaction Binding=Implicit Unbind; Transaction Binding=Explicit Unbind; Unbind implicito causa il disconnessione della connessione dalla transazione al termine della transazione. Dopo la disconnessione, vengono eseguite altre richieste nella connessione in modalità autocommit. La proprietà System.Transactions.Transaction.Current non è verificata quando si eseguono le richieste mentre la transazione è attiva. Dopo il termine della transazione, vengono eseguite altre richieste in modalità autocommit.Se il sistema termina la transazione (nell'ambito di un blocco usando) prima del completamento dell'ultimo comando, verrà generata InvalidOperationException. Unbind esplicito fa sì che la connessione rimanga associata alla transazione fino a quando la connessione non viene chiusa o viene chiamata una chiamata esplicita SqlConnection.TransactionEnlist(null) . A partire da .NET Framework 4.0, le modifiche apportate a Unbind implicito rendono esplicito unbind obsoleto. Viene generata un'eccezione InvalidOperationException se Transaction.Current non è la transazione integrata o se la transazione integrata non è attiva. |
Risoluzione dell'IP di rete trasparente -oppure- TransparentNetworkIPResolution |
Vedere la descrizione. | Quando il valore di questa chiave è impostato su true , l'applicazione deve recuperare tutti gli indirizzi IP per una particolare voce DNS e tentare la connessione al primo nell'elenco. Se la connessione non viene stabilita entro 0,5 secondi, l'applicazione tenterà di connettersi a tutti gli altri in parallelo. Quando il primo risponde, l'applicazione stabilirà la connessione con l'indirizzo IP che ha risposto.Se la MultiSubnetFailover chiave è impostata su true , TransparentNetworkIPResolution viene ignorata.Se la Failover Partner chiave è impostata, TransparentNetworkIPResolution viene ignorata.Il valore di questa chiave deve essere true , , yes false o no .Un valore di yes viene considerato uguale a un valore di true .Un valore di no viene considerato uguale a un valore di false .I valori predefiniti sono i seguenti:
|
TrustServerCertificate -oppure- TrustServerCertificate |
'false' | Se impostato su true , TLS viene usato per crittografare il canale quando si ignora la catena di certificati per convalidare l'attendibilità. Se TrustServerCertificate è impostato su true e Encrypt è impostato su false , il canale non viene crittografato. I valori riconosciuti sono true , false , yes e no . Per altre informazioni, vedere Sintassi della stringa di connessione. |
Tipo versione del sistema | N/D | Valore stringa che indica il sistema di tipo previsto dall'applicazione. Le funzionalità disponibili per un'applicazione client dipendono dalla versione di SQL Server e dal livello di compatibilità del database. L'impostazione esplicita della versione del sistema di tipi per cui l'applicazione client è stata scritta consente di evitare potenziali problemi che potrebbero causare l'interruzione di un'applicazione se viene utilizzata una versione di SQL Server diversa. Nota: Impossibile impostare la versione del sistema di tipo per il codice CLR (Common Language Runtime) che esegue in-process in SQL Server. Per altre informazioni, vedere SQL Server Integrazione di Common Language Runtime. I valori possibili sono: Type System Version=SQL Server 2012; Type System Version=SQL Server 2008; Type System Version=SQL Server 2005; Type System Version=Latest; Type System Version=SQL Server 2012; specifica che l'applicazione richiederà la versione 11.0.0.0 di Microsoft.SqlServer.Types.dll. Le altre Type System Version impostazioni richiedono la versione 10.0.0.0 di Microsoft.SqlServer.Types.dll.Latest è obsoleto e non deve essere usato. Latest equivale a: Type System Version=SQL Server 2008; . |
ID utente -oppure- UID -oppure- Utente |
N/D | Account di accesso SQL Server. Non consigliata. Per mantenere un livello elevato di sicurezza, è consigliabile usare invece le Integrated Security parole chiave o Trusted_Connection . SqlCredentialè un modo più sicuro per specificare le credenziali per una connessione che usa SQL Server Autenticazione.L'ID utente deve essere di 128 caratteri o meno. |
Istanza utente | 'false' | Valore che indica se reindirizzare la connessione dall'istanza predefinita SQL Server Express a un'istanza avviata dal runtime in esecuzione nell'account del chiamante. |
ID workstation -oppure- WSID |
Nome del computer locale | Nome della workstation che si connette a SQL Server. L'ID deve essere di 128 caratteri o minore. |
L'elenco seguente contiene i nomi validi per il pool di connessioni all'interno di ConnectionString. Per altre informazioni, vedere Pool di connessioni SQL Server (ADO.NET).
Durata della connessione (o Timeout di bilanciamento del carico)
Inserisci
Dimensione max pool
Dimensione min pool
Pooling
Quando si impostano valori di pool di parole chiave o connessione che richiedono un valore booleano, è possibile usare 'sì' anziché 'true', e 'no' anziché 'false'. I valori integer sono rappresentati come stringhe.
Nota
Il provider di dati .NET Framework per SQL Server usa il proprio protocollo per comunicare con SQL Server. Pertanto, non supporta l'uso di un nome origine dati ODBC (DSN) durante la connessione a SQL Server perché non aggiunge un livello ODBC.
Nota
I file UDL (Universal Data Link) non sono supportati per il provider di dati .NET Framework per SQL Server.
Attenzione
In questa versione, l'applicazione deve prestare attenzione quando si costruisce un stringa di connessione in base all'input dell'utente, ad esempio quando si recuperano l'ID utente e le informazioni sulla password da una finestra di dialogo e la si aggiunge alla stringa di connessione. L'applicazione deve assicurarsi che un utente non possa incorporare parametri di stringa di connessione aggiuntivi in questi valori, ad esempio immettendo una password come "validpassword; database=somedb" in un tentativo di collegamento a un database diverso. Se è necessario costruire stringhe di connessione in base all'input utente, usare il nuovo SqlConnectionStringBuilder, che convalida il stringa di connessione e consente di eliminare questo problema. Per altre informazioni, vedere Generatori di stringhe di connessione .