Proprietà ConnectionString (ADO)

Indica le informazioni usate per stabilire una connessione a un'origine dati.

Impostazioni e valori restituiti

Imposta o restituisce un valore String.

Osservazioni

Utilizzare la proprietà ConnectionString per specificare un'origine dati passando una stringa di connessione dettagliata contenente una serie di istruzioni argument= value separate da punto e virgola.

ADO supporta cinque argomenti per la proprietà ConnectionString; qualsiasi altro argomento passa direttamente al provider senza alcuna elaborazione da parte di ADO. Gli argomenti supportati da ADO sono i seguenti.

Argomento Descrizione
Provider= Specifica il nome di un provider da utilizzare per la connessione.
File Name= Specifica il nome di un file specifico del provider, ad esempio un oggetto origine dati persistente, contenente informazioni di connessione predefinite.
Remote Provider= Specifica il nome di un provider da utilizzare quando si apre una connessione lato client. (Solo Servizio dati remoti.)
Remote Server= Specifica il nome del percorso del server da utilizzare quando si apre una connessione lato client. (Solo Servizio dati remoti.)
URL= Specifica la stringa di connessione come URL assoluto che identifica una risorsa, ad esempio un file o una directory.

Dopo aver impostato la proprietà ConnectionString e aperto l'oggetto Connection, il provider può modificare il contenuto della proprietà, ad esempio eseguendo il mapping dei nomi degli argomenti definiti da ADO ai relativi equivalenti per il provider specifico.

La proprietà ConnectionString eredita automaticamente il valore utilizzato per l'argomento ConnectionString del metodo Open, pertanto è possibile eseguire l'override della proprietà ConnectionString corrente durante la chiamata al metodo Open.

Poiché l'argomento File Name fa sì che ADO carichi il provider associato, non è possibile passare entrambi gli argomenti Provider e File Name.

La proprietà ConnectionString è di lettura/scrittura quando la connessione viene chiusa e di sola lettura quando è aperta.

I duplicati di un argomento nella proprietà ConnectionString vengono ignorati. Viene utilizzata l'ultima istanza di ogni argomento.

Nota

Utilizzo di Servizio dati remoti Se utilizzata in un oggetto Connection lato client, la proprietà ConnectionString può includere solo i parametri Remote Provider e Remote Server.

La tabella seguente elenca il provider ADO predefinito per ogni sistema operativo Windows:

Provider ADO predefinito Sistema operativo Windows
MSDASQL

Per migliorare la leggibilità del codice sorgente, specificare in modo esplicito il nome del provider nella stringa di connessione.
Windows 2000 (32 bit)

Windows XP (32 bit)

Windows 2003 Server (32 bit)

Windows Vista (32 bit)

Windows Vista Service Pack 1 o versione successiva (32 bit e 64 bit)

Versioni di Windows dopo Windows Vista (32 bit e 64 bit)
Nessuna impostazione predefinita.

Quando un'applicazione ADO viene eseguita nei sistemi operativi seguenti e non specifica il provider in modo esplicito, ADO restituisce l'errore seguente: "ADODB.Connection: il provider non è specificato e non esiste alcun provider predefinito designato"
Windows 2000 (64 bit)

Windows XP (64 bit)

Windows 2003 Server (64 bit)

Windows Vista (64 bit)

Si applica a

Oggetto Connection (ADO)

Vedere anche

Esempio delle proprietà ConnectionString, ConnectionTimeout e State (VB)
Esempio di proprietà ConnectionString, ConnectionTimeout e State (VC++)
Appendice A: Provider